@timeback/sdk 0.1.9 → 0.1.11

package/dist/client/namespaces/activity.d.ts

@@ -2,31 +2,47 @@
  * Activity Namespace
  *
  * Activity creation and management.
+ * Enforces single-activity-at-a-time: calling `start()` while an activity
+ * is already running throws an error.
  */
 import { Activity } from '../lib/activity';
-import type { ActivityEndPayload, ActivityParams } from '../../shared/types';
+import type { ActivityParams } from '../../shared/types';
+import type { ActivityTransportConfig } from '../lib/activity/types';
 /**
  * Activity namespace for starting and managing activities.
+ *
+ * Only one activity can be active at a time. Calling `start()` while
+ * an activity is already running throws an error. End the current
+ * activity first via `end()`.
  */
 export declare class ActivityManager {
-    private readonly sendActivity;
+    private readonly transport;
+    private _current;
     /**
      * Create activity manager.
      *
-     * @param sendActivity - Function to send activity to server
+     * @param config - Transport configuration
      */
-    constructor(sendActivity: (payload: ActivityEndPayload) => Promise<void>);
+    constructor(config: ActivityTransportConfig);
+    /**
+     * The currently active activity, or `null` if none.
+     *
+     * @returns The current activity or null
+     */
+    get current(): Activity | null;
     /**
      * Start a new activity.
      *
-     * The activity timer begins immediately. Use `pause()`, `resume()`, and `end()`
-     * to control the activity lifecycle.
+     * Throws if an activity is already running. End the current activity
+     * first before starting a new one.
      *
      * @param params - Activity parameters
      * @returns Started activity instance
+     * @throws If an activity is already active
      *
-     * @example Basic usage
+     * @example
      * ```typescript
+     * // Basic usage
      * const activity = timeback.activity.start({
      *   id: 'lesson-1',
      *   name: 'Intro',
@@ -34,11 +50,37 @@ export declare class ActivityManager {
      * })
      * // ... user completes lesson ...
      * await activity.end({
+     *   xpEarned: 100,
      *   totalQuestions: 10,
      *   correctQuestions: 8,
      *   pctComplete: 67,
      * })
      * ```
+     *
+     * @example
+     * ```typescript
+     * // Resume from previous session
+     * // Use the same runId from a previous session to correlate events
+     * const activity = timeback.activity.start({
+     *   id: 'lesson-1',
+     *   name: 'Intro',
+     *   course: { subject: 'Math', grade: 3 },
+     *   runId: savedRunId, // from previous session
+     * })
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Custom heartbeat interval
+     * const activity = timeback.activity.start({
+     *   id: 'lesson-1',
+     *   name: 'Intro',
+     *   course: { subject: 'Math', grade: 3 },
+     *   time: {
+     *     flushIntervalMs: 30000, // 30 seconds
+     *   },
+     * })
+     * ```
      */
     start(params: ActivityParams): Activity;
 }

package/dist/client/namespaces/activity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../../src/client/namespaces/activity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE1C,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAE5E;;GAEG;AACH,qBAAa,eAAe;IAMf,OAAO,CAAC,QAAQ,CAAC,YAAY;IALzC;;;;OAIG;IACH,YAA6B,YAAY,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,EAAI;IAE7F;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,CAAC,MAAM,EAAE,cAAc,GAAG,QAAQ,CAEtC;CACD"}
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../../src/client/namespaces/activity.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAG1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAEpE;;;;;;GAMG;AACH,qBAAa,eAAe;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAA;IAC1B,OAAO,CAAC,QAAQ,CAAwB;IAExC;;;;OAIG;IACH,YAAY,MAAM,EAAE,uBAAuB,EAE1C;IAED;;;;OAIG;IACH,IAAI,OAAO,IAAI,QAAQ,GAAG,IAAI,CAK7B;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmDG;IACH,KAAK,CAAC,MAAM,EAAE,cAAc,GAAG,QAAQ,CAUtC;CACD"}

package/dist/client/timeback-client.class.d.ts

@@ -24,6 +24,13 @@ interface TimebackClientConfig {
      * global `window.fetch`.
      */
     plugins?: TimebackClientPlugin | TimebackClientPlugin[];
+    /**
+     * Credentials policy for fetch requests.
+     *
+     * Defaults to `'include'` (sends cookies cross-origin). Use `'same-origin'`
+     * or `'omit'` for token-based or cross-origin setups where cookies are not needed.
+     */
+    credentials?: RequestCredentials;
 }
 /**
  * Timeback client for activity tracking and identity.
@@ -46,7 +53,6 @@ export declare class TimebackClient {
      * @returns The base URL
      */
     private get baseURL();
-    private sendActivity;
 }
 export {};
 //# sourceMappingURL=timeback-client.class.d.ts.map

package/dist/client/timeback-client.class.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timeback-client.class.d.ts","sourceRoot":"","sources":["../../src/client/timeback-client.class.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAG1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEvE;;GAEG;AACH,UAAU,oBAAoB;IAC7B,6FAA6F;IAC7F,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,aAAa,CAAA;IACrB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,oBAAoB,GAAG,oBAAoB,EAAE,CAAA;CACvD;AAED;;GAEG;AACH,qBAAa,cAAc;IAC1B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAA;IAClC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IAEtC;;;;OAIG;IACH,YAAY,MAAM,GAAE,oBAAyB,EAmB5C;IAED;;;;OAIG;IACH,OAAO,KAAK,OAAO,GAYlB;YAOa,YAAY;CAiB1B"}
+{"version":3,"file":"timeback-client.class.d.ts","sourceRoot":"","sources":["../../src/client/timeback-client.class.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAE1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEvE;;GAEG;AACH,UAAU,oBAAoB;IAC7B,6FAA6F;IAC7F,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,aAAa,CAAA;IACrB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,oBAAoB,GAAG,oBAAoB,EAAE,CAAA;IACvD;;;;;OAKG;IACH,WAAW,CAAC,EAAE,kBAAkB,CAAA;CAChC;AAED;;GAEG;AACH,qBAAa,cAAc;IAC1B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAA;IAClC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IAEtC;;;;OAIG;IACH,YAAY,MAAM,GAAE,oBAAyB,EAwB5C;IAED;;;;OAIG;IACH,OAAO,KAAK,OAAO,GAYlB;CACD"}

package/dist/client.d.ts

@@ -1,7 +1,7 @@
 /**
  * Timeback Client
  *
- * Framework-agnostic client exports.
+ * Client exports.
  *
  * @example
  * ```typescript

package/dist/client.js

@@ -1 +1 @@
-import{e as o,f as y,g as b}from"./chunk-8gg8n8v9.js";function r(e){let i=e.headerName??"Authorization",k=e.prefix??"Bearer ";return{wrapFetch(s){return async(t,m)=>{let a=await e.getToken();if(!a)throw Error("Missing bearer token (are you authenticated yet?)");let c=new Headers(m?.headers??(t instanceof Request?t.headers:void 0));if(!c.has(i))c.set(i,`${k}${a}`);return s(t,{...m,headers:c})}}}}export{b as createClient,r as bearer,y as TimebackClient,o as Activity};
+import{e as y,f as b,g as l}from"./chunk-92nnwa7t.js";function r(e){let i=e.headerName??"Authorization",o=e.prefix??"Bearer ";return{wrapFetch(x){return async(t,m)=>{let a=await e.getToken();if(!a)throw Error("Missing bearer token (are you authenticated yet?)");let c=new Headers(m?.headers??(t instanceof Request?t.headers:void 0));if(!c.has(i))c.set(i,`${o}${a}`);return x(t,{...m,headers:c})}}}}export{l as createClient,r as bearer,b as TimebackClient,y as Activity};

package/dist/identity.d.ts

@@ -3,11 +3,8 @@
  *
  * This entrypoint is intentionally minimal: identity-only SSO, with types.
  *
- * For edge runtimes like Cloudflare Workers / workerd, prefer `timeback/edge`,
- * which includes edge-safe helpers (like `toNativeHandler`) alongside identity-only.
- *
- * If you're running in a Node.js server runtime, prefer importing from `timeback`
- * to get the full SDK (including `createTimeback()` and `timeback.api`).
+ * If you need `toNativeHandler`, `ROUTES`, or the full SDK, import from
+ * `@timeback/sdk` instead — the main entry is edge-compatible.
  */
 export { createTimebackIdentity } from './server/timeback-identity';
 export type { IdentityOnlyConfig, IdentityOnlyInstance, IdentityOnlyHandlers } from './server';

package/dist/identity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAA;AACnE,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA"}
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAA;AACnE,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA"}

package/dist/identity.js

@@ -1 +1 @@
-import{c as e}from"./chunk-63afdp3y.js";import"./chunk-whc53e0y.js";export{e as createTimebackIdentity};
+import{d as e}from"./chunk-1cqa51je.js";import"./chunk-6b0ppq9d.js";import"./chunk-3ew9vn2d.js";import"./chunk-edk3nfj7.js";export{e as createTimebackIdentity};

package/dist/index.d.ts

@@ -3,8 +3,9 @@
  *
  * Server-side exports for the Timeback SDK.
  *
- * @example Full SDK (activity tracking + identity)
+ * @example
  * ```typescript
+ * // Full SDK (activity tracking + identity)
  * import { createTimeback } from '@timeback/sdk'
  *
  * export const timeback = await createTimeback({
@@ -20,8 +21,9 @@
  * })
  * ```
  *
- * @example Identity-only (SSO without activity tracking)
+ * @example
  * ```typescript
+ * // Identity-only (SSO without activity tracking)
  * import { createTimebackIdentity } from '@timeback/sdk'
  *
  * export const timeback = createTimebackIdentity({
@@ -38,7 +40,9 @@
  * ```
  */
 export { createTimeback, createTimebackIdentity } from './server';
+export { toNativeHandler } from './server/adapters/native';
+export { ROUTES } from './shared/constants';
 export { TimebackClient } from '@timeback/core';
-export type { ApiCredentials, CustomIdentityConfig, Environment, IdentityConfig, SsoIdentityConfig, TimebackConfig, TimebackInstance, IdentityOnlyConfig, IdentityOnlyInstance, IdentityOnlyHandlers, BuildStateContext, CallbackSuccessContext, IdentityOnlyCallbackSuccessContext, CallbackErrorContext, OIDCTokens, OIDCUserInfo, IdpData, TimebackUserResolutionErrorCode, } from './server';
+export type { ApiCredentials, CustomIdentityConfig, Environment, IdentityConfig, SsoIdentityConfig, TimebackConfig, TimebackInstance, IdentityOnlyConfig, IdentityOnlyInstance, IdentityOnlyHandlers, BuildStateContext, CallbackSuccessContext, IdentityOnlyCallbackSuccessContext, CallbackErrorContext, OIDCTokens, OIDCUserInfo, IdpData, ActivityBeforeSendData, TimeSpentBeforeSendData, TimebackUserResolutionErrorCode, } from './server';
 export type { TimebackIdentity, TimebackProfile, TimebackSessionUser, IdentityClaims, TimebackAuthUser, ActivityParams, ActivityMetrics, } from './shared/types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AAEjE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAE/C,YAAY,EACX,cAAc,EACd,oBAAoB,EACpB,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,kCAAkC,EAClC,oBAAoB,EACpB,UAAU,EACV,YAAY,EACZ,OAAO,EACP,+BAA+B,GAC/B,MAAM,UAAU,CAAA;AAEjB,YAAY,EACX,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,eAAe,GACf,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AAEjE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAE3C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAE/C,YAAY,EACX,cAAc,EACd,oBAAoB,EACpB,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,kCAAkC,EAClC,oBAAoB,EACpB,UAAU,EACV,YAAY,EACZ,OAAO,EACP,sBAAsB,EACtB,uBAAuB,EACvB,+BAA+B,GAC/B,MAAM,UAAU,CAAA;AAEjB,YAAY,EACX,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,eAAe,GACf,MAAM,gBAAgB,CAAA"}