@timeback/sdk 0.1.4

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

@@ -0,0 +1,294 @@
+/**
+ * Server Adapter Types
+ *
+ * Public type definitions for server framework adapters.
+ */
+import type { Handlers, IdentityOnlyHandlers, IdentityOnlyInstance, TimebackInstance } from '../types';
+/**
+ * Flexible input that accepts either a TimebackInstance or just the handlers.
+ *
+ * Allows both:
+ * - `toNextjsHandler(timeback)`
+ * - `toNextjsHandler(timeback.handle)`
+ */
+export type TimebackInput = TimebackInstance | Handlers;
+/**
+ * Flexible input that accepts either an IdentityOnlyInstance or just the handlers.
+ *
+ * Allows both:
+ * - `toNextjsHandler(timeback)`
+ * - `toNextjsHandler(timeback.handle)`
+ */
+export type IdentityOnlyInput = IdentityOnlyInstance | IdentityOnlyHandlers;
+/**
+ * Union of all valid inputs for adapters.
+ *
+ * Adapters accept either full Timeback instances or identity-only instances.
+ */
+export type AnyTimebackInput = TimebackInput | IdentityOnlyInput;
+/**
+ * Next.js route handlers.
+ */
+export interface NextjsHandlers {
+    GET: (req: Request) => Promise<Response>;
+    POST: (req: Request) => Promise<Response>;
+    PUT: (req: Request) => Promise<Response>;
+    DELETE: (req: Request) => Promise<Response>;
+    PATCH: (req: Request) => Promise<Response>;
+}
+/**
+ * Minimal request interface compatible with Express and similar frameworks.
+ *
+ * Works with: Express, Polka, Fastify (with express compat), Restify, etc.
+ */
+export interface ExpressLikeRequest {
+    method: string;
+    url: string;
+    headers: Record<string, string | string[] | undefined>;
+    body?: unknown;
+    protocol: string;
+    get: (name: string) => string | undefined;
+}
+/**
+ * Minimal response interface compatible with Express and similar frameworks.
+ *
+ * Works with: Express, Polka, Fastify (with express compat), Restify, etc.
+ */
+export interface ExpressLikeResponse {
+    status: (code: number) => ExpressLikeResponse;
+    set: (headers: Record<string, string>) => ExpressLikeResponse;
+    json: (data: unknown) => void;
+    send: (body: string) => void;
+    redirect: (url: string) => void;
+}
+/**
+ * Next function for Express-like middleware.
+ */
+export type ExpressLikeNext = () => void;
+/**
+ * Minimal router interface compatible with Express and similar frameworks.
+ *
+ * Works with: Express.Router(), Polka, etc.
+ */
+export interface ExpressLikeRouter {
+    get: (path: string, handler: ExpressLikeHandler) => void;
+    post: (path: string, handler: ExpressLikeHandler) => void;
+    use: (handler: ExpressLikeHandler) => void;
+}
+/**
+ * Express-like middleware handler type.
+ */
+export type ExpressLikeHandler = (req: ExpressLikeRequest, res: ExpressLikeResponse, next: ExpressLikeNext) => void;
+/**
+ * Options for the native handler.
+ */
+export interface NativeHandlerOptions {
+    /** Timeback instance or handlers (full or identity-only) */
+    timeback: AnyTimebackInput;
+    /**
+     * Custom callback path for OAuth redirect.
+     *
+     * When your IdP uses a custom redirect URI that doesn't match the SDK's
+     * default `/identity/callback` path, set this to match your `redirectUri`.
+     *
+     * @example '/api/auth/sso/callback/timeback'
+     */
+    callbackPath?: string;
+}
+/**
+ * Minimal SvelteKit RequestEvent-compatible structure.
+ *
+ * Uses generics to accept SvelteKit's full RequestEvent without requiring the dependency.
+ */
+export interface SvelteKitRequestEvent {
+    request: Request;
+    url: URL;
+}
+/**
+ * Options for the SvelteKit handler hook.
+ *
+ * Uses generics to properly type the resolve function with the actual SvelteKit event type.
+ */
+export interface SvelteKitHandlerOptions<TEvent extends SvelteKitRequestEvent = SvelteKitRequestEvent> {
+    /** Timeback instance or handlers (full or identity-only) */
+    timeback: AnyTimebackInput;
+    /** SvelteKit request event */
+    event: TEvent;
+    /** SvelteKit resolve function */
+    resolve: (event: TEvent) => Response | Promise<Response>;
+    /** Whether SvelteKit is building (from `$app/environment`) */
+    building?: boolean;
+    /** Base path for Timeback routes (default: '/api/timeback') */
+    basePath?: string;
+    /**
+     * Custom callback path for OAuth redirects.
+     *
+     * If your IdP has a pre-registered callback URL that differs from the SDK default
+     * (`/api/timeback/identity/callback`), specify the path here so the handler can
+     * intercept it.
+     *
+     * @example '/api/auth/sso/callback/timeback'
+     */
+    callbackPath?: string;
+}
+/**
+ * SvelteKit RequestHandler type.
+ *
+ * Compatible with SvelteKit's `RequestHandler` from `@sveltejs/kit`.
+ */
+export type SvelteKitRequestHandler = (event: {
+    request: Request;
+}) => Promise<Response>;
+/**
+ * SvelteKit route handlers.
+ */
+export interface SvelteKitHandlers {
+    GET: SvelteKitRequestHandler;
+    POST: SvelteKitRequestHandler;
+    PUT: SvelteKitRequestHandler;
+    DELETE: SvelteKitRequestHandler;
+    PATCH: SvelteKitRequestHandler;
+}
+/**
+ * Minimal SolidStart APIEvent-compatible structure.
+ */
+export interface SolidStartEvent {
+    request: Request;
+}
+/**
+ * Options for the SolidStart middleware handler.
+ */
+export interface SolidStartHandlerOptions {
+    /** Timeback instance or handlers (full or identity-only) */
+    timeback: AnyTimebackInput;
+    /** SolidStart event containing the request */
+    event: SolidStartEvent;
+    /** Base path for Timeback routes (default: '/api/timeback') */
+    basePath?: string;
+    /**
+     * Custom callback path for OAuth redirects.
+     *
+     * If your IdP has a pre-registered callback URL that differs from the SDK default
+     * (`/api/timeback/identity/callback`), specify the path here so the handler can
+     * intercept it.
+     *
+     * @example '/api/auth/sso/callback/timeback'
+     */
+    callbackPath?: string;
+}
+/**
+ * SolidStart RequestHandler type.
+ *
+ * Compatible with SolidStart's APIEvent handler pattern.
+ */
+export type SolidStartRequestHandler = (event: {
+    request: Request;
+}) => Response | Promise<Response>;
+/**
+ * SolidStart route handlers.
+ */
+export interface SolidStartHandlers {
+    GET: SolidStartRequestHandler;
+    POST: SolidStartRequestHandler;
+    PUT: SolidStartRequestHandler;
+    DELETE: SolidStartRequestHandler;
+    PATCH: SolidStartRequestHandler;
+}
+/**
+ * TanStack Start route event.
+ */
+export interface TanStackStartEvent {
+    request: Request;
+}
+/**
+ * TanStack Start RequestHandler type.
+ */
+export type TanStackStartRequestHandler = (event: TanStackStartEvent) => Response | Promise<Response>;
+/**
+ * TanStack Start route handlers.
+ */
+export interface TanStackStartHandlers {
+    GET: TanStackStartRequestHandler;
+    POST: TanStackStartRequestHandler;
+    PUT: TanStackStartRequestHandler;
+    DELETE: TanStackStartRequestHandler;
+    PATCH: TanStackStartRequestHandler;
+}
+/**
+ * Options for the TanStack Start handler.
+ */
+export interface TanStackStartHandlerOptions {
+    /** Timeback instance or handlers (full or identity-only) */
+    timeback: AnyTimebackInput;
+    /** Custom callback path for OAuth (if different from default) */
+    callbackPath?: string;
+}
+/**
+ * Minimal Node.js IncomingMessage-like interface.
+ *
+ * Used for fallback request conversion when `event.request` is not available.
+ */
+export interface NodeLikeIncomingMessage {
+    method?: string;
+    url?: string;
+    headers: Record<string, string | string[] | undefined>;
+    on: (event: 'data' | 'end' | 'error', listener: (chunk?: Buffer | Error) => void) => void;
+}
+/**
+ * Minimal H3Event-compatible structure for Nuxt 3.
+ *
+ * This interface supports two patterns:
+ * 1. Modern H3 with `event.request` (Web Request API) - preferred
+ * 2. Legacy/fallback with `event.node.req` (Node IncomingMessage)
+ *
+ * We check for `event.request` first, falling back to `event.node.req` for
+ * environments where the Web Request isn't directly available.
+ */
+export interface NuxtLikeEvent {
+    /** Web Request (preferred, available in modern H3/Nitro) */
+    request?: Request;
+    /** Node.js request/response objects (fallback) */
+    node?: {
+        req: NodeLikeIncomingMessage;
+    };
+    /** Request path */
+    path?: string;
+}
+/**
+ * Options for the Nuxt middleware handler.
+ */
+export interface NuxtHandlerOptions<TEvent extends NuxtLikeEvent = NuxtLikeEvent> {
+    /** Timeback instance or handlers (full or identity-only) */
+    timeback: AnyTimebackInput;
+    /** Nuxt/H3 event */
+    event: TEvent;
+    /** Base path for Timeback routes (default: '/api/timeback') */
+    basePath?: string;
+    /**
+     * Custom callback path for OAuth redirects.
+     *
+     * If your IdP has a pre-registered callback URL that differs from the SDK default
+     * (`/api/timeback/identity/callback`), specify the path here so the handler can
+     * intercept it.
+     *
+     * @example '/api/auth/sso/callback/timeback'
+     */
+    callbackPath?: string;
+}
+/**
+ * Nuxt RequestHandler type.
+ *
+ * Compatible with Nuxt 3's defineEventHandler pattern.
+ */
+export type NuxtRequestHandler = (event: NuxtLikeEvent) => Response | Promise<Response>;
+/**
+ * Nuxt route handlers.
+ */
+export interface NuxtHandlers {
+    GET: NuxtRequestHandler;
+    POST: NuxtRequestHandler;
+    PUT: NuxtRequestHandler;
+    DELETE: NuxtRequestHandler;
+    PATCH: NuxtRequestHandler;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/server/adapters/utils.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Server Adapter Utilities
+ *
+ * Shared utilities for server framework adapters.
+ */
+import type { Handlers, IdentityOnlyHandlers } from '../types';
+import type { AnyTimebackInput } from './types';
+/**
+ * Union of handler types returned by getHandlers.
+ */
+type AnyHandlers = Handlers | IdentityOnlyHandlers;
+/**
+ * A canonical route identifier for Timeback's built-in endpoints.
+ */
+type TimebackRouteId = 'identity.signIn' | 'identity.callback' | 'identity.signOut' | 'user.me' | 'activity';
+/**
+ * Normalize a path-like string to a pathname only (no query string).
+ *
+ * Some frameworks may provide path-like values that include a query string
+ * (e.g. `/api/timeback/identity/signin?returnTo=/`). Route matching should
+ * operate on pathnames only.
+ *
+ * @param path - Path-like string (may include query string)
+ * @returns Pathname only (no query string)
+ */
+export declare function normalizePathname(path: string): string;
+/**
+ * Attempt to map a request to a Timeback built-in route.
+ *
+ * This consolidates route matching logic so adapters don't each re-implement
+ * their own `endsWith(...)` chains.
+ *
+ * Matching strategy:
+ * - If `callbackPath` is provided and equals the request pathname, treat it as
+ *   the identity callback route (GET only).
+ * - If `basePath` is provided, match *exactly* against `basePath + ROUTES.*`
+ *   by stripping the base path and comparing the relative path.
+ * - If `basePath` is not provided, fall back to suffix matching (`endsWith`)
+ *   to support catch-all mounts where the mount prefix isn't known.
+ *
+ * @param params - Matching inputs
+ * @param params.pathname - Request pathname (may include query string; will be normalized)
+ * @param params.method - HTTP method
+ * @param params.basePath - Optional base path (recommended when available)
+ * @param params.callbackPath - Optional custom callback path
+ * @returns A matched route id, or null if not a Timeback route
+ */
+export declare function matchTimebackRoute(params: {
+    pathname: string;
+    method: string;
+    basePath?: string;
+    callbackPath?: string;
+}): TimebackRouteId | null;
+/**
+ * Extract handlers from flexible input.
+ *
+ * @param input - TimebackInstance, IdentityOnlyInstance, or their handlers
+ * @returns Handlers object (full or identity-only)
+ */
+export declare function getHandlers(input: AnyTimebackInput): AnyHandlers;
+/**
+ * Check if handlers include activity tracking (full SDK).
+ *
+ * @param handlers - Handlers to check
+ * @returns True if handlers include activity tracking
+ */
+export declare function hasActivityHandler(handlers: AnyHandlers): handlers is Handlers;
+/**
+ * Check if handlers include user handlers (full SDK).
+ *
+ * @param handlers - Handlers to check
+ * @returns True if handlers include user handlers
+ */
+export declare function hasUserHandler(handlers: AnyHandlers): handlers is Handlers;
+export {};
+//# sourceMappingURL=utils.d.ts.map

package/dist/server/adapters/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/server/adapters/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C;;GAEG;AACH,KAAK,WAAW,GAAG,QAAQ,GAAG,oBAAoB,CAAA;AAElD;;GAEG;AACH,KAAK,eAAe,GACjB,iBAAiB,GACjB,mBAAmB,GACnB,kBAAkB,GAClB,SAAS,GACT,UAAU,CAAA;AAEb;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqBtD;AA8BD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IAC1C,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;CACrB,GAAG,eAAe,GAAG,IAAI,CAsDzB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,WAAW,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,GAAG,QAAQ,IAAI,QAAQ,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,WAAW,GAAG,QAAQ,IAAI,QAAQ,CAE1E"}

package/dist/server/handlers/activity.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Activity Handlers
+ *
+ * Route handlers for activity tracking.
+ */
+import type { ApiCredentials, AppConfig, Environment, IdentityConfig } from '../types';
+/**
+ * Configuration for the activity handler.
+ */
+interface ActivityHandlerConfig {
+    env: Environment;
+    identity: IdentityConfig;
+    appConfig: AppConfig;
+    api: ApiCredentials;
+}
+/**
+ * Activity handler type.
+ */
+type ActivityHandler = (req: Request) => Promise<Response>;
+/**
+ * Create the activity POST handler.
+ *
+ * @param config - Handler configuration
+ * @returns The activity request handler
+ */
+export declare function createActivityHandler(config: ActivityHandlerConfig): ActivityHandler;
+export {};
+//# sourceMappingURL=activity.d.ts.map

package/dist/server/handlers/activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/activity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA0BH,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAuFtF;;GAEG;AACH,UAAU,qBAAqB;IAC9B,GAAG,EAAE,WAAW,CAAA;IAChB,QAAQ,EAAE,cAAc,CAAA;IACxB,SAAS,EAAE,SAAS,CAAA;IACpB,GAAG,EAAE,cAAc,CAAA;CACnB;AAED;;GAEG;AACH,KAAK,eAAe,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AAE1D;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,eAAe,CAqIpF"}

package/dist/server/handlers/identity-full.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Identity Handlers (full SDK)
+ *
+ * This module includes Timeback user resolution and therefore depends on Timeback API access.
+ */
+import type { TimebackClient } from '@timeback/core';
+import type { ApiCredentials, Environment, IdentityConfig } from '../types';
+type FullIdentityHandlerParams<TState = unknown> = {
+    env: Environment;
+    identity: IdentityConfig<TState>;
+    api: {
+        credentials: ApiCredentials;
+        getClient: () => TimebackClient;
+    };
+};
+/**
+ * Create identity route handlers (full SDK).
+ *
+ * @param params - Handler configuration
+ * @returns Identity handlers
+ */
+export declare function createIdentityHandlers<TState = unknown>(params: FullIdentityHandlerParams<TState>): {
+    signIn: (req: Request) => Promise<Response>;
+    callback: (req: Request) => Promise<Response>;
+    signOut: () => Response;
+};
+export {};
+//# sourceMappingURL=identity-full.d.ts.map

package/dist/server/handlers/identity-full.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-full.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/identity-full.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiBH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,KAAK,EACX,cAAc,EAGd,WAAW,EACX,cAAc,EAEd,MAAM,UAAU,CAAA;AAEjB,KAAK,yBAAyB,CAAC,MAAM,GAAG,OAAO,IAAI;IAClD,GAAG,EAAE,WAAW,CAAA;IAChB,QAAQ,EAAE,cAAc,CAAC,MAAM,CAAC,CAAA;IAChC,GAAG,EAAE;QACJ,WAAW,EAAE,cAAc,CAAA;QAC3B,SAAS,EAAE,MAAM,cAAc,CAAA;KAC/B,CAAA;CACD,CAAA;AAwQD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,GAAG,OAAO,EACtD,MAAM,EAAE,yBAAyB,CAAC,MAAM,CAAC,GACvC;IACF,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC3C,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC7C,OAAO,EAAE,MAAM,QAAQ,CAAA;CACvB,CAQA"}

package/dist/server/handlers/identity-only.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Identity Handlers (identity-only)
+ *
+ * This module is intentionally minimal and does NOT import Timeback API client code.
+ * It is safe to include in edge runtimes (e.g. Cloudflare Workers / workerd).
+ */
+import type { Environment, IdentityOnlyCallbackSuccessContext, SsoIdentityConfig } from '../types';
+/**
+ * Create identity route handlers (identity-only mode).
+ *
+ * @param params - Handler configuration
+ * @returns Identity-only handlers
+ */
+export declare function createIdentityOnlyHandlers<TState = unknown>(params: {
+    env: Environment;
+    identity: SsoIdentityConfig<TState, IdentityOnlyCallbackSuccessContext<TState>>;
+}): {
+    signIn: (req: Request) => Promise<Response>;
+    callback: (req: Request) => Promise<Response>;
+    signOut: () => Response;
+};
+//# sourceMappingURL=identity-only.d.ts.map

package/dist/server/handlers/identity-only.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-only.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/identity-only.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAEX,WAAW,EACX,kCAAkC,EAClC,iBAAiB,EACjB,MAAM,UAAU,CAAA;AAuPjB;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,EAAE;IACpE,GAAG,EAAE,WAAW,CAAA;IAChB,QAAQ,EAAE,iBAAiB,CAAC,MAAM,EAAE,kCAAkC,CAAC,MAAM,CAAC,CAAC,CAAA;CAC/E;;;;EAYA"}

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

@@ -0,0 +1,9 @@
+/**
+ * Server Handlers
+ *
+ * Route handlers for Timeback server operations.
+ */
+export { createIdentityHandlers } from './identity-full';
+export { createActivityHandler } from './activity';
+export { createUserHandler } from './user';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAA"}

package/dist/server/handlers/user.d.ts

@@ -0,0 +1,31 @@
+/**
+ * User Handlers
+ *
+ * Route handlers for user profile data.
+ */
+import type { ApiCredentials, AppConfig, Environment, IdentityConfig } from '../types';
+/**
+ * Configuration for the user handler.
+ */
+interface UserHandlerConfig {
+    env: Environment;
+    identity: IdentityConfig;
+    api: ApiCredentials;
+    appConfig: AppConfig;
+}
+/**
+ * User handler type.
+ */
+type UserHandler = (req: Request) => Promise<Response>;
+/**
+ * Create the user profile handler.
+ *
+ * Returns the current user's profile, including identity and enriched data
+ * from the Timeback API.
+ *
+ * @param config - Handler configuration
+ * @returns The user profile request handler
+ */
+export declare function createUserHandler(config: UserHandlerConfig): UserHandler;
+export {};
+//# sourceMappingURL=user.d.ts.map

package/dist/server/handlers/user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/user.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAItF;;GAEG;AACH,UAAU,iBAAiB;IAC1B,GAAG,EAAE,WAAW,CAAA;IAChB,QAAQ,EAAE,cAAc,CAAA;IACxB,GAAG,EAAE,cAAc,CAAA;IACnB,SAAS,EAAE,SAAS,CAAA;CACpB;AAED;;GAEG;AACH,KAAK,WAAW,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AAEtD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAyFxE"}

package/dist/server/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Timeback Server SDK
+ *
+ * Server-side exports for the Timeback SDK.
+ */
+export { createTimeback } from './timeback';
+export { createTimebackIdentity } from './timeback-identity';
+export type { TimebackConfig, TimebackInstance, Environment, ApiCredentials, IdentityConfig, SsoIdentityConfig, CustomIdentityConfig, Handlers, IdentityOnlyConfig, IdentityOnlyInstance, IdentityOnlyHandlers, BuildStateContext, CallbackSuccessContext, IdentityOnlyCallbackSuccessContext, CallbackErrorContext, OIDCTokens, OIDCUserInfo, IdpData, TimebackUserResolutionErrorCode, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAC5D,YAAY,EAEX,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,QAAQ,EAER,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EAEpB,iBAAiB,EACjB,sBAAsB,EACtB,kCAAkC,EAClC,oBAAoB,EACpB,UAAU,EACV,YAAY,EACZ,OAAO,EAEP,+BAA+B,GAC/B,MAAM,SAAS,CAAA"}

package/dist/server/lib/build-activity-events.d.ts

@@ -0,0 +1,39 @@
+import type { ActivityCompletedEvent, TimebackActivityContext, TimebackActivityMetric, TimeSpentEvent, TimeSpentMetric } from '@timeback/caliper';
+import type { TimebackClient } from '@timeback/core';
+import type { ActivityEndPayload, ActivityMetrics } from '../../shared/types';
+import type { AppConfig } from '../types';
+/**
+ * Build a Timeback activity context for Caliper events.
+ *
+ * @param payload - Validated activity payload
+ * @param course - Matched course config
+ * @param appName - Timeback app display name
+ * @param apiEnv - Target Timeback API environment
+ * @returns Caliper activity context payload
+ */
+export declare function buildActivityContext(payload: ActivityEndPayload, course: AppConfig['courses'][number], appName: string, apiEnv: 'staging' | 'production'): TimebackActivityContext;
+/**
+ * Build Caliper activity metrics from the client payload.
+ *
+ * @param metrics - Activity metrics from the client
+ * @returns Normalized Caliper activity metrics
+ */
+export declare function buildActivityMetrics(metrics: ActivityMetrics): TimebackActivityMetric[];
+/**
+ * Build Caliper time spent metrics from elapsed and paused times.
+ *
+ * @param elapsedMs - Active time in milliseconds
+ * @param pausedMs - Paused time in milliseconds
+ * @returns Normalized Caliper time spent metrics
+ */
+export declare function buildTimeSpentMetrics(elapsedMs: number, pausedMs: number): TimeSpentMetric[];
+/**
+ * Send a batch of Caliper events as a single envelope.
+ *
+ * @param client - Timeback API client
+ * @param sensor - Caliper sensor URL
+ * @param activityEvent - ActivityEvent payload
+ * @param timeSpentEvent - TimeSpentEvent payload
+ */
+export declare function sendCaliperEnvelope(client: TimebackClient, sensor: string, activityEvent: ActivityCompletedEvent, timeSpentEvent: TimeSpentEvent): Promise<void>;
+//# sourceMappingURL=build-activity-events.d.ts.map

package/dist/server/lib/build-activity-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-activity-events.d.ts","sourceRoot":"","sources":["../../../src/server/lib/build-activity-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EAEtB,cAAc,EACd,eAAe,EACf,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEzC;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CACnC,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EACpC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,SAAS,GAAG,YAAY,GAC9B,uBAAuB,CAgBzB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,sBAAsB,EAAE,CAoBvF;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE,CAQ5F;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACxC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,sBAAsB,EACrC,cAAc,EAAE,cAAc,GAC5B,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/server/lib/build-user-profile.d.ts

@@ -0,0 +1,62 @@
+import type { AppConfig } from '../types';
+type EnrollmentGoals = NonNullable<AppConfig['courses'][number]['metadata']>['goals'];
+type EnrollmentLike = {
+    course: {
+        id: string;
+        title: string;
+    };
+    metadata?: {
+        goals?: EnrollmentGoals;
+    };
+};
+type ActivityFacts = Record<string, Record<string, {
+    activityMetrics?: {
+        xpEarned?: number;
+    };
+}>>;
+/**
+ * Build a lookup for configured courses keyed by their environment-specific IDs.
+ *
+ * @param courses - App course config
+ * @param apiEnv - Target Timeback API environment
+ * @returns Map of courseId → course config
+ */
+export declare function buildCourseLookup(courses: AppConfig['courses'], apiEnv: 'staging' | 'production'): Map<string, AppConfig['courses'][number]>;
+/**
+ * Map enrollments to the TimebackProfile course shape.
+ *
+ * @param enrollments - Enrollment list
+ * @param courseById - Lookup for configured courses
+ * @returns Normalized course list for profile
+ */
+export declare function mapEnrollmentsToCourses(enrollments: EnrollmentLike[], courseById: Map<string, AppConfig['courses'][number]>): Array<{
+    id: string;
+    code: string;
+    name: string;
+}>;
+/**
+ * Pick a goals object from enrollments, if present.
+ *
+ * @param enrollments - Enrollment list
+ * @returns Goals metadata or undefined
+ */
+export declare function pickGoalsFromEnrollments(enrollments: EnrollmentLike[]): EnrollmentGoals | undefined;
+/**
+ * Calculate UTC day range for a given date.
+ *
+ * @param date - Date to anchor the range
+ * @returns Start/end timestamps for the UTC day
+ */
+export declare function getUtcDayRange(date: Date): {
+    start: Date;
+    end: Date;
+};
+/**
+ * Sum XP values from Edubridge activity facts.
+ *
+ * @param facts - Activity facts by date and subject
+ * @returns Total XP
+ */
+export declare function sumXp(facts: ActivityFacts): number;
+export {};
+//# sourceMappingURL=build-user-profile.d.ts.map

package/dist/server/lib/build-user-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-user-profile.d.ts","sourceRoot":"","sources":["../../../src/server/lib/build-user-profile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEzC,KAAK,eAAe,GAAG,WAAW,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;AAErF,KAAK,cAAc,GAAG;IACrB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACrC,QAAQ,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,eAAe,CAAA;KAAE,CAAA;CACtC,CAAA;AAED,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,eAAe,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC,CAAC,CAAA;AAEhG;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,EAC7B,MAAM,EAAE,SAAS,GAAG,YAAY,GAC9B,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAW3C;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACtC,WAAW,EAAE,cAAc,EAAE,EAC7B,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,GACnD,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAUnD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACvC,WAAW,EAAE,cAAc,EAAE,GAC3B,eAAe,GAAG,SAAS,CAE7B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,IAAI,CAAA;CAAE,CAQrE;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CASlD"}