timeback 0.0.0-alpha.2 → 0.1.1

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

@@ -0,0 +1,280 @@
+/**
+ * Server Adapter Types
+ *
+ * Public type definitions for server framework adapters.
+ */
+import type { Handlers, 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;
+/**
+ * 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 */
+    timeback: TimebackInput;
+    /**
+     * 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 */
+    timeback: TimebackInput;
+    /** 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 */
+    timeback: TimebackInput;
+    /** 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 */
+    timeback: TimebackInput;
+    /** 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 */
+    timeback: TimebackInput;
+    /** 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,15 @@
+/**
+ * Server Adapter Utilities
+ *
+ * Shared utilities for server framework adapters.
+ */
+import type { Handlers } from '../types';
+import type { TimebackInput } from './types';
+/**
+ * Extract handlers from flexible input.
+ *
+ * @param input - TimebackInstance or Handlers
+ * @returns Handlers object
+ */
+export declare function getHandlers(input: TimebackInput): Handlers;
+//# 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;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,QAAQ,CAE1D"}

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;
+    apiCredentials: 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;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAkCtF;;GAEG;AACH,UAAU,qBAAqB;IAC9B,GAAG,EAAE,WAAW,CAAA;IAChB,QAAQ,EAAE,cAAc,CAAA;IACxB,SAAS,EAAE,SAAS,CAAA;IACpB,cAAc,EAAE,cAAc,CAAA;CAC9B;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,CAuCpF"}

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

@@ -0,0 +1,24 @@
+/**
+ * Identity Handlers
+ *
+ * Route handlers for SSO identity operations.
+ * User session state is managed by your own auth system via the hooks.
+ */
+import type { Environment, IdentityConfig } from '../types';
+interface IdentityHandlerParams {
+    env: Environment;
+    identity: IdentityConfig;
+}
+/**
+* Create identity route handlers.
+ *
+* @param params - Handler configuration
+* @returns Identity handlers
+*/
+export declare function createIdentityHandlers(params: IdentityHandlerParams): {
+    signIn: (req: Request) => Promise<Response>;
+    callback: (req: Request) => Promise<Response>;
+    signOut: () => Response;
+};
+export {};
+//# sourceMappingURL=identity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/identity.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,OAAO,KAAK,EAGX,WAAW,EACX,cAAc,EAEd,MAAM,UAAU,CAAA;AAEjB,UAAU,qBAAqB;IAC9B,GAAG,EAAE,WAAW,CAAA;IAChB,QAAQ,EAAE,cAAc,CAAA;CACxB;AAqPA;;;;;EAKE;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,qBAAqB;;;;EAQnE"}

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

@@ -0,0 +1,9 @@
+/**
+ * Server Handlers
+ *
+ * Route handlers for Timeback server operations.
+ */
+export { createIdentityHandlers } from './identity';
+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,YAAY,CAAA;AACnD,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,30 @@
+/**
+ * User Handlers
+ *
+ * Route handlers for user profile data.
+ */
+import type { ApiCredentials, Environment, IdentityConfig } from '../types';
+/**
+ * Configuration for the user handler.
+ */
+interface UserHandlerConfig {
+    env: Environment;
+    identity: IdentityConfig;
+    apiCredentials: ApiCredentials;
+}
+/**
+ * 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;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAE3E;;GAEG;AACH,UAAU,iBAAiB;IAC1B,GAAG,EAAE,WAAW,CAAA;IAChB,QAAQ,EAAE,cAAc,CAAA;IACxB,cAAc,EAAE,cAAc,CAAA;CAC9B;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,CA4BxE"}

package/dist/server/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Timeback Server SDK
+ *
+ * Server-side exports for the Timeback SDK.
+ */
+export { createServer } from './timeback';
+export type { TimebackConfig, TimebackInstance, Environment, ApiCredentials, IdentityConfig, SsoIdentityConfig, CustomIdentityConfig, Handlers, BuildStateContext, CallbackSuccessContext, CallbackErrorContext, OIDCTokens, OIDCUserInfo, } from './types';
+export type { CallbackSuccessContext as IdentityCallbackSuccess } from './types';
+export type { CallbackErrorContext as IdentityCallbackError } 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,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,YAAY,EACX,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,QAAQ,EACR,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,UAAU,EACV,YAAY,GACZ,MAAM,SAAS,CAAA;AAEhB,YAAY,EAAE,sBAAsB,IAAI,uBAAuB,EAAE,MAAM,SAAS,CAAA;AAChF,YAAY,EAAE,oBAAoB,IAAI,qBAAqB,EAAE,MAAM,SAAS,CAAA"}

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

@@ -0,0 +1,9 @@
+/**
+ * Server Library
+ *
+ * Internal utilities for the server SDK.
+ */
+export { getIssuer, buildAuthorizationUrl, exchangeCodeForTokens, getUserInfo } from './oidc';
+export { jsonResponse, redirectResponse, encodeBase64Url, decodeBase64Url } from './utils';
+export { ssoLog, oidcLog, createScopedLogger } from './logger';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/lib/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAC7F,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAC1F,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA"}

package/dist/server/lib/logger.d.ts

@@ -0,0 +1,21 @@
+/**
+ * SDK Logger
+ *
+ * Debug logging for the Timeback SDK server components.
+ * Only logs when DEBUG=1 or DEBUG=true is set.
+ */
+import type { Logger } from '@timeback/internal-logger';
+/**
+ * Create a scoped logger for SDK components.
+ *
+ * Only logs debug/info when DEBUG=1 or DEBUG=true.
+ *
+ * @param scope - Logger scope name (e.g., 'sso', 'oidc')
+ * @returns Configured logger instance
+ */
+export declare function createScopedLogger(scope: string): Logger;
+/** Logger for SSO/identity operations */
+export declare const ssoLog: Logger;
+/** Logger for OIDC protocol operations */
+export declare const oidcLog: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/server/lib/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/server/lib/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAgBvD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED,yCAAyC;AACzC,eAAO,MAAM,MAAM,QAA4B,CAAA;AAE/C,0CAA0C;AAC1C,eAAO,MAAM,OAAO,QAA6B,CAAA"}

package/dist/server/lib/oidc.d.ts

@@ -0,0 +1,76 @@
+/**
+ * OIDC Helpers
+ *
+ * Helpers for Timeback SSO via OIDC with automatic endpoint discovery.
+ */
+import type { Environment, OIDCTokens, OIDCUserInfo } from '../types';
+/**
+ * OIDC Discovery document structure.
+ */
+interface OIDCDiscoveryDocument {
+    issuer: string;
+    authorization_endpoint: string;
+    token_endpoint: string;
+    userinfo_endpoint: string;
+    jwks_uri: string;
+    end_session_endpoint?: string;
+}
+/** Parameters for building an authorization URL. */
+interface BuildAuthorizationUrlParams {
+    issuer: string;
+    clientId: string;
+    redirectUri: string;
+    state: string;
+}
+/** Parameters for exchanging an authorization code for tokens. */
+interface ExchangeCodeParams {
+    issuer: string;
+    clientId: string;
+    clientSecret: string;
+    code: string;
+    redirectUri: string;
+}
+/** Parameters for fetching user info. */
+interface GetUserInfoParams {
+    issuer: string;
+    accessToken: string;
+}
+/**
+ * Fetch the OIDC discovery document for an issuer.
+ *
+ * @param issuer - The OIDC issuer URL
+ * @returns The discovery document
+ */
+export declare function fetchDiscoveryDocument(issuer: string): Promise<OIDCDiscoveryDocument>;
+/**
+ * Get the Timeback IdP issuer URL for the given environment.
+ *
+ * Uses AWS Cognito User Pools as the identity provider.
+ *
+ * @param env - The environment
+ * @returns The issuer URL
+ */
+export declare function getIssuer(env: Environment): string;
+/**
+ * Build the authorization URL for OIDC.
+ *
+ * @param params - Authorization parameters
+ * @returns The authorization URL
+ */
+export declare function buildAuthorizationUrl(params: BuildAuthorizationUrlParams): Promise<string>;
+/**
+ * Exchange authorization code for tokens.
+ *
+ * @param params - Token exchange parameters
+ * @returns The token response
+ */
+export declare function exchangeCodeForTokens(params: ExchangeCodeParams): Promise<OIDCTokens>;
+/**
+ * Get user info from the IdP.
+ *
+ * @param params - User info request parameters
+ * @returns The user info claims
+ */
+export declare function getUserInfo(params: GetUserInfoParams): Promise<OIDCUserInfo>;
+export {};
+//# sourceMappingURL=oidc.d.ts.map

package/dist/server/lib/oidc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oidc.d.ts","sourceRoot":"","sources":["../../../src/server/lib/oidc.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAErE;;GAEG;AACH,UAAU,qBAAqB;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,sBAAsB,EAAE,MAAM,CAAA;IAC9B,cAAc,EAAE,MAAM,CAAA;IACtB,iBAAiB,EAAE,MAAM,CAAA;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED,oDAAoD;AACpD,UAAU,2BAA2B;IACpC,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;CACb;AAED,kEAAkE;AAClE,UAAU,kBAAkB;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;CACnB;AAED,yCAAyC;AACzC,UAAU,iBAAiB;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;CACnB;AAKD;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAuB3F;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CASlD;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,MAAM,CAAC,CAWhG;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CA4B3F;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAclF"}

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

@@ -0,0 +1,39 @@
+/**
+ * Server Utilities
+ *
+ * Internal utility functions for the server SDK.
+ */
+/**
+ * Create a JSON response.
+ *
+ * @param data - Response data
+ * @param status - HTTP status code
+ * @param headers - Additional headers
+ * @returns JSON response
+ */
+export declare function jsonResponse<T>(data: T, status?: number, headers?: HeadersInit): Response;
+/**
+ * Create a redirect response.
+ *
+ * @param url - URL to redirect to
+ * @param headers - Additional headers (e.g., Set-Cookie)
+ * @returns Redirect response
+ */
+export declare function redirectResponse(url: string, headers?: HeadersInit): Response;
+/**
+ * Encode an object to a base64url-safe string.
+ *
+ * Used for OIDC state parameter.
+ *
+ * @param data - Data to encode
+ * @returns Base64url encoded string
+ */
+export declare function encodeBase64Url(data: unknown): string;
+/**
+ * Decode a base64url string back to an object.
+ *
+ * @param encoded - Base64url encoded string
+ * @returns Decoded object
+ */
+export declare function decodeBase64Url<T>(encoded: string): T;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/server/lib/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,SAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,QAAQ,CAItF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,QAAQ,CAI7E;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAIrD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,CAKrD"}

package/dist/server/timeback.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Timeback Server SDK
+ *
+ * Factory function to create the Timeback server instance.
+ */
+import type { TimebackConfig, TimebackInstance } from './types';
+/**
+ * Create a Timeback server instance.
+ *
+ * Returns a framework-agnostic instance with raw handlers.
+ * Use an adapter to integrate with your framework:
+ * - `toNextjsHandler()` for Next.js App Router
+ * - `toHonoApp()` / `toHonoMiddleware()` for Hono
+ * - `toExpressMiddleware()` / `mountExpressRoutes()` for Express
+ *
+ * @param config - Server configuration
+ * @returns Timeback instance with handlers
+ *
+ * @example
+ * ```typescript
+ * import { createServer } from 'timeback'
+ * import { toNextjsHandler } from 'timeback/nextjs'
+ *
+ * const timeback = await createServer({
+ *   env: 'production',
+ *   api: {
+ *     clientId: process.env.TIMEBACK_API_CLIENT_ID!,
+ *     clientSecret: process.env.TIMEBACK_API_CLIENT_SECRET!,
+ *   },
+ *   identity: {
+ *     mode: 'custom',
+ *     getUser: async (req) => {
+ *       const session = await getSession(req)
+ *       return {
+ *         id: session.userId,
+ *         email: session.user.email,
+ *         name: session.user.name,
+ *       }
+ *     },
+ *   },
+ * })
+ *
+ * // For Next.js App Router
+ * export const { GET, POST } = toNextjsHandler(timeback)
+ * ```
+ */
+export declare function createServer(config: TimebackConfig): Promise<TimebackInstance>;
+//# sourceMappingURL=timeback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timeback.d.ts","sourceRoot":"","sources":["../../src/server/timeback.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAwCpF"}