@timeback/sdk 0.1.6 → 0.1.8

package/dist/client/adapters/react/index.js

@@ -1,296 +1,4 @@
-// src/shared/constants.ts
-var DEFAULT_BASE_PATH = "/api/timeback";
-var ROUTES = {
-  ACTIVITY: "/activity",
-  IDENTITY: {
-    SIGNIN: "/identity/signin",
-    SIGNOUT: "/identity/signout",
-    CALLBACK: "/identity/callback"
-  },
-  USER: {
-    ME: "/user/me"
-  }
-};
-
-// src/client/lib/utils.ts
-function isBrowser() {
-  return typeof window !== "undefined";
-}
-function getDefaultBaseURL() {
-  if (!isBrowser()) {
-    return;
-  }
-  return `${window.location.origin}${DEFAULT_BASE_PATH}`;
-}
-
-// src/client/lib/activity/activity.class.ts
-class Activity {
-  params;
-  sendActivity;
-  _startedAt;
-  _isPaused = false;
-  _pausedAt;
-  _totalPausedMs = 0;
-  _ended = false;
-  constructor(params, sendActivity) {
-    this.params = params;
-    this.sendActivity = sendActivity;
-    this._startedAt = new Date;
-  }
-  get startedAt() {
-    return this._startedAt;
-  }
-  get isPaused() {
-    return this._isPaused;
-  }
-  get elapsedMs() {
-    if (this._ended) {
-      return 0;
-    }
-    const now = new Date;
-    let elapsed = now.getTime() - this._startedAt.getTime() - this._totalPausedMs;
-    if (this._isPaused && this._pausedAt) {
-      elapsed -= now.getTime() - this._pausedAt.getTime();
-    }
-    return Math.max(0, elapsed);
-  }
-  _buildPayload(data) {
-    const now = new Date;
-    const pausedMs = this._totalPausedMs + (this._isPaused && this._pausedAt ? now.getTime() - this._pausedAt.getTime() : 0);
-    const elapsedMs = now.getTime() - this._startedAt.getTime() - pausedMs;
-    return {
-      id: this.params.id,
-      name: this.params.name,
-      course: this.params.course,
-      startedAt: this._startedAt.toISOString(),
-      endedAt: now.toISOString(),
-      elapsedMs: Math.max(0, elapsedMs),
-      pausedMs,
-      metrics: {
-        totalQuestions: data.totalQuestions,
-        correctQuestions: data.correctQuestions,
-        ...data.xpEarned === undefined ? {} : { xpEarned: data.xpEarned },
-        ...data.masteredUnits === undefined ? {} : { masteredUnits: data.masteredUnits }
-      },
-      ...data.attemptNumber === undefined ? {} : { attemptNumber: data.attemptNumber },
-      ...data.pctCompleteApp === undefined ? {} : { pctCompleteApp: data.pctCompleteApp }
-    };
-  }
-  pause() {
-    if (this._isPaused || this._ended)
-      return;
-    this._isPaused = true;
-    this._pausedAt = new Date;
-  }
-  resume() {
-    if (!this._isPaused || this._ended || !this._pausedAt)
-      return;
-    this._totalPausedMs += new Date().getTime() - this._pausedAt.getTime();
-    this._isPaused = false;
-    this._pausedAt = undefined;
-  }
-  async end(data) {
-    if (this._ended)
-      return;
-    this._ended = true;
-    if (this._isPaused && this._pausedAt) {
-      this._totalPausedMs += new Date().getTime() - this._pausedAt.getTime();
-      this._isPaused = false;
-      this._pausedAt = undefined;
-    }
-    const payload = this._buildPayload(data);
-    await this.sendActivity(payload);
-  }
-}
-// src/client/namespaces/activity.ts
-class ActivityManager {
-  sendActivity;
-  constructor(sendActivity) {
-    this.sendActivity = sendActivity;
-  }
-  start(params) {
-    return new Activity(params, this.sendActivity);
-  }
-}
-// src/client/namespaces/auth.ts
-class Auth {
-  getBaseURL;
-  constructor(getBaseURL) {
-    this.getBaseURL = getBaseURL;
-  }
-  signIn() {
-    if (!isBrowser()) {
-      throw new Error("signIn() requires a browser environment");
-    }
-    window.location.href = `${this.getBaseURL()}${ROUTES.IDENTITY.SIGNIN}`;
-  }
-}
-// src/client/namespaces/user.ts
-class User {
-  getBaseURL;
-  constructor(getBaseURL) {
-    this.getBaseURL = getBaseURL;
-  }
-  async fetch() {
-    if (!isBrowser()) {
-      throw new Error("user.fetch() requires a browser environment");
-    }
-    const response = await fetch(`${this.getBaseURL()}${ROUTES.USER.ME}`, {
-      method: "GET",
-      credentials: "include"
-    });
-    if (!response.ok) {
-      const errorResponse = await response.json().catch(() => ({ error: "Unknown error" }));
-      throw new Error(errorResponse.error ?? "Failed to fetch user profile");
-    }
-    return response.json();
-  }
-}
-// src/client/timeback-client.class.ts
-class TimebackClient {
-  activity;
-  auth;
-  user;
-  _baseURL;
-  constructor(config = {}) {
-    this._baseURL = config.baseURL;
-    this.activity = new ActivityManager((payload) => this.sendActivity(payload));
-    this.auth = new Auth(() => this.baseURL);
-    this.user = new User(() => this.baseURL);
-  }
-  get baseURL() {
-    if (!this._baseURL) {
-      const resolved = getDefaultBaseURL();
-      if (!resolved) {
-        throw new Error("Timeback client requires a browser environment for default baseURL. " + "Provide an explicit baseURL for server-side usage.");
-      }
-      this._baseURL = resolved;
-    }
-    return this._baseURL;
-  }
-  async sendActivity(payload) {
-    const response = await fetch(`${this.baseURL}${ROUTES.ACTIVITY}`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(payload),
-      credentials: "include"
-    });
-    if (!response.ok) {
-      const errorResponse = await response.json().catch(() => ({ error: "Unknown error" }));
-      throw new Error(errorResponse.error ?? "Failed to send activity");
-    }
-  }
-}
-
-// src/client/timeback-client.ts
-function createClient(config = {}) {
-  const baseURL = config.baseURL ?? getDefaultBaseURL();
-  return new TimebackClient({ baseURL });
-}
-// src/client/adapters/react/provider.tsx
-import * as React from "react";
-import { jsx } from "react/jsx-runtime";
-var TimebackContext = React.createContext(undefined);
-var clientInstance;
-function getOrCreateClient() {
-  if (!clientInstance) {
-    clientInstance = new TimebackClient;
-  }
-  return clientInstance;
-}
-function TimebackProvider({
-  client: providedClient,
-  children
-}) {
-  const [client, setClient] = React.useState(providedClient);
-  React.useEffect(() => {
-    if (!client) {
-      setClient(providedClient ?? getOrCreateClient());
-    }
-  }, [client, providedClient]);
-  return /* @__PURE__ */ jsx(TimebackContext.Provider, {
-    value: client,
-    children
-  });
-}
-function useTimeback() {
-  return React.useContext(TimebackContext);
-}
-// src/client/adapters/react/SignInButton.tsx
-import * as React2 from "react";
-import { jsx as jsx2, jsxs } from "react/jsx-runtime";
-function TimebackLogo({ className }) {
-  return /* @__PURE__ */ jsxs("svg", {
-    className,
-    width: "20",
-    height: "18",
-    viewBox: "0 0 199 180",
-    fill: "none",
-    xmlns: "http://www.w3.org/2000/svg",
-    "aria-hidden": "true",
-    children: [
-      /* @__PURE__ */ jsxs("g", {
-        clipPath: "url(#tb-logo-clip)",
-        children: [
-          /* @__PURE__ */ jsx2("path", {
-            d: "M121.432 179.456C110.607 177.871 101.153 173.91 92.4882 168.085C91.1274 167.17 89.4598 165.404 89.4375 164.008C89.2123 149.891 89.3002 135.77 89.3002 119.86C93.1365 123.255 95.8538 125.706 98.6224 128.099C103.151 132.012 107.437 136.28 112.314 139.703C126.466 149.635 145.037 147.25 156.045 134.448C166.919 121.803 167.226 101.374 155.695 89.6399C145.727 79.4958 134.693 70.3995 123.251 60.0438C123.251 77.8871 123.251 94.5637 123.251 112.15C121.428 110.999 120.279 110.479 119.383 109.676C110.329 101.573 101.241 93.5044 92.3634 85.2109C90.8519 83.7988 89.4363 81.3758 89.4209 79.4084C89.2249 54.4218 89.2905 29.4332 89.3061 4.44502C89.3066 3.64954 89.3061 2.22136 89.3061 1.47755C90.8061 1.47755 92.694 1.47857 94.1427 1.47755C118.131 1.46071 142.12 1.52088 166.108 1.39821C169.235 1.38222 171.33 2.18661 173.251 4.75826C180.607 14.6032 188.189 24.279 196.266 34.7705C179.79 34.7705 164.169 34.7705 148.548 34.7705C147.871 34.7705 147.366 34.7705 146.866 34.7705C147.866 35.7705 150.35 38.3018 151.61 39.4825C162.643 49.8249 174.663 59.3807 184.245 70.947C202.474 92.9508 203.539 118.134 191.204 143.046C178.598 168.508 156.61 180.302 128.298 180.295C126.154 180.295 124.011 179.778 121.432 179.456Z",
-            fill: "currentColor"
-          }),
-          /* @__PURE__ */ jsx2("circle", {
-            cx: "40",
-            cy: "133",
-            r: "39",
-            fill: "currentColor"
-          }),
-          /* @__PURE__ */ jsx2("circle", {
-            cx: "39",
-            cy: "39",
-            r: "39",
-            fill: "currentColor"
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsx2("defs", {
-        children: /* @__PURE__ */ jsx2("clipPath", {
-          id: "tb-logo-clip",
-          children: /* @__PURE__ */ jsx2("rect", {
-            width: "199",
-            height: "180",
-            fill: "currentColor"
-          })
-        })
-      })
-    ]
-  });
-}
-function LoadingSpinner({ className }) {
-  return /* @__PURE__ */ jsxs("svg", {
-    className,
-    width: "16",
-    height: "16",
-    viewBox: "0 0 24 24",
-    fill: "none",
-    xmlns: "http://www.w3.org/2000/svg",
-    "aria-hidden": "true",
-    children: [
-      /* @__PURE__ */ jsx2("circle", {
-        cx: "12",
-        cy: "12",
-        r: "10",
-        stroke: "currentColor",
-        strokeWidth: "2",
-        strokeOpacity: "0.25"
-      }),
-      /* @__PURE__ */ jsx2("path", {
-        d: "M12 2C6.48 2 2 6.48 2 12",
-        stroke: "currentColor",
-        strokeWidth: "2",
-        strokeLinecap: "round"
-      })
-    ]
-  });
-}
-var defaultStyles = `
+import{a as AA,b as I,c as KA}from"../../../chunk-ahy54f2r.js";import*as B from"react";import{jsx as l}from"react/jsx-runtime";var g=B.createContext(void 0),S;function h(){if(!S)S=new I;return S}function o({client:A,children:M}){let[U,K]=B.useState(A);return B.useEffect(()=>{if(!U)K(A??h())},[U,A]),l(g.Provider,{value:U,children:M})}function V(){return B.useContext(g)}import*as z from"react";var r=1500,H=new WeakMap,N=new WeakMap;function m(A){return!!A&&Date.now()-A.atMs<r}function k(A){return A.verified?{status:"verified",timebackId:A.timebackId}:{status:"unverified"}}async function s(A,M){if(!M){let K=N.get(A);if(m(K))return K.result;let q=H.get(A);if(q)return await q}let U=A.user.verify().then((K)=>{if(H.get(A)===U)N.set(A,{atMs:Date.now(),result:K});return K});H.set(A,U);try{return await U}finally{if(H.get(A)===U)H.delete(A)}}function F(A={}){let M=V(),U=A.enabled??!0,[K,q]=z.useState({status:"loading"}),[_,D]=z.useState(0),G=z.useRef(0),E=z.useCallback(()=>{D((Q)=>Q+1)},[]);return z.useEffect(()=>{if(!U)return;let Q=!1,X=_>G.current;if(M&&!X){let J=N.get(M);if(m(J))return q(k(J.result)),()=>{Q=!0}}return q({status:"loading"}),(async()=>{try{if(!M)return;if(X)G.current=_;let J=await s(M,X);if(Q)return;q(k(J))}catch(J){if(!Q)q({status:"error",message:J instanceof Error?J.message:"Failed to verify Timeback user"})}})(),()=>{Q=!0}},[U,_,M]),{state:K,refresh:E}}import*as $ from"react";var P=new WeakMap,C=new WeakMap;function u(A){return!!A&&Date.now()-A.atMs<5000}async function b(A,M){if(!M){let K=C.get(A);if(u(K))return K.profile;let q=P.get(A);if(q)return await q}let U=A.user.fetch().then((K)=>{if(P.get(A)===U)C.set(A,{atMs:Date.now(),profile:K});return K});P.set(A,U);try{return await U}finally{if(P.get(A)===U)P.delete(A)}}function v(A){let M=C.get(A);return u(M)?M.profile:void 0}function n(A={}){let{enabled:M=!0,auto:U=!1}=A,K=V(),{state:q}=F({enabled:M}),[_,D]=$.useState({status:"idle"}),[G,E]=$.useState(0),[Q,X]=$.useState(0),J=$.useRef(0),L=$.useRef(0),O=M&&q.status==="verified"&&!!K,j=$.useCallback(()=>{if(!O)return;E((Y)=>Y+1)},[O]),x=$.useCallback(()=>{if(!O)return;X((Y)=>Y+1)},[O]),w=$.useRef(!1);return $.useEffect(()=>{if(!M){D({status:"idle"});return}if(q.status!=="verified"){D((Z)=>Z.status==="idle"?Z:{status:"idle"}),w.current=!1;return}if(U&&!w.current&&G===0){w.current=!0,E(1);return}if(G===0&&Q===0)return;let Y=!1,f=G>J.current,y=Q>L.current,p=y;if(!f&&!y){if(K){let Z=v(K);if(Z)return D({status:"loaded",profile:Z}),()=>{Y=!0}}return}if(K&&!p){let Z=v(K);if(Z)return D({status:"loaded",profile:Z}),J.current=G,()=>{Y=!0}}return D({status:"loading"}),(async()=>{try{if(!K)return;J.current=G,L.current=Q;let Z=await b(K,p);if(Y)return;D({status:"loaded",profile:Z})}catch(Z){if(!Y)D({status:"error",message:Z instanceof Error?Z.message:"Failed to fetch profile"})}})(),()=>{Y=!0}},[M,q.status,G,Q,K,U]),{state:_,canFetch:O,fetchProfile:j,refresh:x}}import*as R from"react";import{jsx as W,jsxs as T}from"react/jsx-runtime";function c({className:A}){return T("svg",{className:A,width:"20",height:"18",viewBox:"0 0 199 180",fill:"none",xmlns:"http://www.w3.org/2000/svg","aria-hidden":"true",children:[T("g",{clipPath:"url(#tb-logo-clip)",children:[W("path",{d:"M121.432 179.456C110.607 177.871 101.153 173.91 92.4882 168.085C91.1274 167.17 89.4598 165.404 89.4375 164.008C89.2123 149.891 89.3002 135.77 89.3002 119.86C93.1365 123.255 95.8538 125.706 98.6224 128.099C103.151 132.012 107.437 136.28 112.314 139.703C126.466 149.635 145.037 147.25 156.045 134.448C166.919 121.803 167.226 101.374 155.695 89.6399C145.727 79.4958 134.693 70.3995 123.251 60.0438C123.251 77.8871 123.251 94.5637 123.251 112.15C121.428 110.999 120.279 110.479 119.383 109.676C110.329 101.573 101.241 93.5044 92.3634 85.2109C90.8519 83.7988 89.4363 81.3758 89.4209 79.4084C89.2249 54.4218 89.2905 29.4332 89.3061 4.44502C89.3066 3.64954 89.3061 2.22136 89.3061 1.47755C90.8061 1.47755 92.694 1.47857 94.1427 1.47755C118.131 1.46071 142.12 1.52088 166.108 1.39821C169.235 1.38222 171.33 2.18661 173.251 4.75826C180.607 14.6032 188.189 24.279 196.266 34.7705C179.79 34.7705 164.169 34.7705 148.548 34.7705C147.871 34.7705 147.366 34.7705 146.866 34.7705C147.866 35.7705 150.35 38.3018 151.61 39.4825C162.643 49.8249 174.663 59.3807 184.245 70.947C202.474 92.9508 203.539 118.134 191.204 143.046C178.598 168.508 156.61 180.302 128.298 180.295C126.154 180.295 124.011 179.778 121.432 179.456Z",fill:"currentColor"}),W("circle",{cx:"40",cy:"133",r:"39",fill:"currentColor"}),W("circle",{cx:"39",cy:"39",r:"39",fill:"currentColor"})]}),W("defs",{children:W("clipPath",{id:"tb-logo-clip",children:W("rect",{width:"199",height:"180",fill:"currentColor"})})})]})}function a({className:A}){return T("svg",{className:A,width:"16",height:"16",viewBox:"0 0 24 24",fill:"none",xmlns:"http://www.w3.org/2000/svg","aria-hidden":"true",children:[W("circle",{cx:"12",cy:"12",r:"10",stroke:"currentColor",strokeWidth:"2",strokeOpacity:"0.25"}),W("path",{d:"M12 2C6.48 2 2 6.48 2 12",stroke:"currentColor",strokeWidth:"2",strokeLinecap:"round"})]})}var i=`
 .timeback-signin-btn {
   /* Colors */
   --tb-btn-bg: #0f172a;
@@ -402,74 +110,4 @@ var defaultStyles = `
   from { transform: rotate(0deg); }
   to { transform: rotate(360deg); }
 }
-`;
-var stylesInjected = false;
-function injectStyles() {
-  if (typeof document === "undefined" || stylesInjected)
-    return;
-  const styleEl = document.createElement("style");
-  styleEl.setAttribute("data-timeback-styles", "");
-  styleEl.textContent = defaultStyles;
-  document.head.appendChild(styleEl);
-  stylesInjected = true;
-}
-function SignInButton(props) {
-  const {
-    children = "Sign in with Timeback",
-    className,
-    style,
-    disabled,
-    showLoading = true,
-    onClick,
-    variant = "default",
-    size = "md",
-    showLogo = true
-  } = props;
-  const timeback = useTimeback();
-  const [isLoading, setIsLoading] = React2.useState(false);
-  const isReady = !!timeback;
-  React2.useEffect(() => {
-    injectStyles();
-  }, []);
-  const handleClick = (e) => {
-    if (onClick) {
-      onClick(e);
-      if (e.defaultPrevented)
-        return;
-    }
-    if (showLoading) {
-      setIsLoading(true);
-    }
-    timeback?.auth.signIn();
-  };
-  const classNames = [
-    "timeback-signin-btn",
-    variant !== "default" && `timeback-signin-btn--${variant}`,
-    size !== "md" && `timeback-signin-btn--${size}`,
-    className
-  ].filter(Boolean).join(" ");
-  return /* @__PURE__ */ jsxs("button", {
-    type: "button",
-    className: classNames,
-    style,
-    disabled: disabled || !isReady || isLoading,
-    onClick: handleClick,
-    "aria-busy": isLoading,
-    children: [
-      isLoading ? /* @__PURE__ */ jsx2(LoadingSpinner, {
-        className: "timeback-signin-btn__spinner"
-      }) : showLogo ? /* @__PURE__ */ jsx2(TimebackLogo, {
-        className: "timeback-signin-btn__logo"
-      }) : null,
-      children
-    ]
-  });
-}
-export {
-  useTimeback,
-  createClient,
-  TimebackProvider,
-  TimebackClient,
-  SignInButton,
-  Activity
-};
+`,d=!1;function t(){if(typeof document>"u"||d)return;let A=document.createElement("style");A.setAttribute("data-timeback-styles",""),A.textContent=i,document.head.appendChild(A),d=!0}function e(A){let{children:M="Sign in with Timeback",className:U,style:K,disabled:q,showLoading:_=!0,onClick:D,variant:G="default",size:E="md",showLogo:Q=!0}=A,X=V(),[J,L]=R.useState(!1),O=!!X;R.useEffect(()=>{t()},[]);let j=(w)=>{if(D){if(D(w),w.defaultPrevented)return}if(_)L(!0);X?.auth.signIn()},x=["timeback-signin-btn",G!=="default"&&`timeback-signin-btn--${G}`,E!=="md"&&`timeback-signin-btn--${E}`,U].filter(Boolean).join(" ");return T("button",{type:"button",className:x,style:K,disabled:q||!O||J,onClick:j,"aria-busy":J,children:[J?W(a,{className:"timeback-signin-btn__spinner"}):Q?W(c,{className:"timeback-signin-btn__logo"}):null,M]})}export{F as useTimebackVerification,n as useTimebackProfile,V as useTimeback,KA as createClient,o as TimebackProvider,I as TimebackClient,e as SignInButton,AA as Activity};

package/dist/client/adapters/solid/index.d.ts

@@ -40,6 +40,9 @@ export { Activity, createClient, TimebackClient } from '@timeback/sdk/client';
 export type { ActivityMetrics, ActivityParams, TimebackIdentity } from '@timeback/sdk/client';
 export { TimebackProvider, useTimeback } from './context';
 export type { TimebackProviderProps } from './context';
+export { createTimebackVerification } from './primitives/createTimebackVerification';
+export { createTimebackProfile } from './primitives/createTimebackProfile';
+export type { CreateTimebackProfileOptions, CreateTimebackProfileResult, CreateTimebackVerificationOptions, CreateTimebackVerificationResult, TimebackProfileState, TimebackVerificationState, } from './types';
 export { SignInButton } from './SignInButton';
 export type { SignInButtonProps } from './SignInButton';
 //# sourceMappingURL=index.d.ts.map

package/dist/client/adapters/solid/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/client/adapters/solid/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC7E,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAG7F,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AACzD,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAA;AAGtD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/client/adapters/solid/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC7E,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAG7F,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AACzD,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAA;AAGtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAA;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAA;AAC1E,YAAY,EACX,4BAA4B,EAC5B,2BAA2B,EAC3B,iCAAiC,EACjC,gCAAgC,EAChC,oBAAoB,EACpB,yBAAyB,GACzB,MAAM,SAAS,CAAA;AAGhB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/client/adapters/solid/index.ts

@@ -44,6 +44,18 @@ export type { ActivityMetrics, ActivityParams, TimebackIdentity } from '@timebac
 export { TimebackProvider, useTimeback } from './context'
 export type { TimebackProviderProps } from './context'
 
+// Primitives
+export { createTimebackVerification } from './primitives/createTimebackVerification'
+export { createTimebackProfile } from './primitives/createTimebackProfile'
+export type {
+	CreateTimebackProfileOptions,
+	CreateTimebackProfileResult,
+	CreateTimebackVerificationOptions,
+	CreateTimebackVerificationResult,
+	TimebackProfileState,
+	TimebackVerificationState,
+} from './types'
+
 // Components
 export { SignInButton } from './SignInButton'
 export type { SignInButtonProps } from './SignInButton'

package/dist/client/adapters/solid/primitives/createTimebackProfile.d.ts

@@ -0,0 +1,58 @@
+/**
+ * createTimebackProfile
+ *
+ * Solid primitive for fetching the current user's Timeback profile.
+ *
+ * Composes `createTimebackVerification` internally and only fetches
+ * the profile when the user is verified (i.e., exists in Timeback).
+ */
+import type { CreateTimebackProfileOptions, CreateTimebackProfileResult } from '../types';
+/**
+ * Fetch the current user's Timeback profile.
+ *
+ * Internally uses `createTimebackVerification` to ensure the user
+ * is verified before fetching. When `auto: true`, it automatically fetches
+ * the profile once verified. Otherwise, call `fetchProfile()` manually.
+ *
+ * @param options - Options
+ * @param options.enabled - If false, does nothing and stays in idle state. Defaults to true.
+ * @param options.auto - If true, automatically fetch once verified. Defaults to false.
+ * @returns Profile state and fetch methods
+ *
+ * @example
+ * ```tsx
+ * // Manual fetch
+ * import { createTimebackProfile } from '@timeback/sdk/solid'
+ * import { Show } from 'solid-js'
+ *
+ * function ProfileButton() {
+ *   const { state, canFetch, fetchProfile } = createTimebackProfile()
+ *
+ *   return (
+ *     <Show
+ *       when={state.status === 'loaded'}
+ *       fallback={
+ *         <button onClick={fetchProfile} disabled={!canFetch}>
+ *           {state.status === 'loading' ? 'Loading...' : 'Load Profile'}
+ *         </button>
+ *       }
+ *     >
+ *       <div>XP: {state.profile.xp}</div>
+ *     </Show>
+ *   )
+ * }
+ *
+ * // Auto-fetch
+ * function AutoProfile() {
+ *   const { state } = createTimebackProfile({ auto: true })
+ *
+ *   return (
+ *     <Show when={state.status === 'loading'}>
+ *       <div>Loading...</div>
+ *     </Show>
+ *   )
+ * }
+ * ```
+ */
+export declare function createTimebackProfile(options?: CreateTimebackProfileOptions): CreateTimebackProfileResult;
+//# sourceMappingURL=createTimebackProfile.d.ts.map

package/dist/client/adapters/solid/primitives/createTimebackProfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTimebackProfile.d.ts","sourceRoot":"","sources":["../../../../../src/client/adapters/solid/primitives/createTimebackProfile.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EACX,4BAA4B,EAC5B,2BAA2B,EAE3B,MAAM,UAAU,CAAA;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAgB,qBAAqB,CACpC,OAAO,GAAE,4BAAiC,GACxC,2BAA2B,CA0I7B"}

package/dist/client/adapters/solid/primitives/createTimebackProfile.ts

@@ -0,0 +1,209 @@
+/**
+ * createTimebackProfile
+ *
+ * Solid primitive for fetching the current user's Timeback profile.
+ *
+ * Composes `createTimebackVerification` internally and only fetches
+ * the profile when the user is verified (i.e., exists in Timeback).
+ */
+
+import { createEffect, createMemo, createSignal, onCleanup } from 'solid-js'
+
+import { fetchProfileOnce, getProfileCache } from '../../../lib/user-cache'
+import { useTimeback } from '../context'
+import { createTimebackVerification } from './createTimebackVerification'
+
+import type {
+	CreateTimebackProfileOptions,
+	CreateTimebackProfileResult,
+	TimebackProfileState,
+} from '../types'
+
+/**
+ * Fetch the current user's Timeback profile.
+ *
+ * Internally uses `createTimebackVerification` to ensure the user
+ * is verified before fetching. When `auto: true`, it automatically fetches
+ * the profile once verified. Otherwise, call `fetchProfile()` manually.
+ *
+ * @param options - Options
+ * @param options.enabled - If false, does nothing and stays in idle state. Defaults to true.
+ * @param options.auto - If true, automatically fetch once verified. Defaults to false.
+ * @returns Profile state and fetch methods
+ *
+ * @example
+ * ```tsx
+ * // Manual fetch
+ * import { createTimebackProfile } from '@timeback/sdk/solid'
+ * import { Show } from 'solid-js'
+ *
+ * function ProfileButton() {
+ *   const { state, canFetch, fetchProfile } = createTimebackProfile()
+ *
+ *   return (
+ *     <Show
+ *       when={state.status === 'loaded'}
+ *       fallback={
+ *         <button onClick={fetchProfile} disabled={!canFetch}>
+ *           {state.status === 'loading' ? 'Loading...' : 'Load Profile'}
+ *         </button>
+ *       }
+ *     >
+ *       <div>XP: {state.profile.xp}</div>
+ *     </Show>
+ *   )
+ * }
+ *
+ * // Auto-fetch
+ * function AutoProfile() {
+ *   const { state } = createTimebackProfile({ auto: true })
+ *
+ *   return (
+ *     <Show when={state.status === 'loading'}>
+ *       <div>Loading...</div>
+ *     </Show>
+ *   )
+ * }
+ * ```
+ */
+export function createTimebackProfile(
+	options: CreateTimebackProfileOptions = {},
+): CreateTimebackProfileResult {
+	const { enabled = true, auto = false } = options
+
+	const timeback = useTimeback()
+	const verification = createTimebackVerification({ enabled })
+
+	const [state, setState] = createSignal<TimebackProfileState>({ status: 'idle' })
+	const [fetchNonce, setFetchNonce] = createSignal(0)
+	const [refreshNonce, setRefreshNonce] = createSignal(0)
+
+	let lastHandledFetchNonce = 0
+	let lastHandledRefreshNonce = 0
+	let autoTriggered = false
+
+	const canFetch = createMemo(
+		() => enabled && verification.state.status === 'verified' && !!timeback,
+	)
+
+	const fetchProfile = () => {
+		if (!canFetch()) {
+			return
+		}
+
+		setFetchNonce(n => n + 1)
+	}
+
+	const refresh = () => {
+		if (!canFetch()) {
+			return
+		}
+
+		setRefreshNonce(n => n + 1)
+	}
+
+	createEffect(() => {
+		const verificationState = verification.state
+		const fetchN = fetchNonce()
+		const refreshN = refreshNonce()
+
+		if (!enabled) {
+			setState({ status: 'idle' })
+			return
+		}
+
+		if (verificationState.status !== 'verified') {
+			setState(current => (current.status === 'idle' ? current : { status: 'idle' }))
+			autoTriggered = false
+			return
+		}
+
+		if (auto && !autoTriggered && fetchN === 0 && refreshN === 0) {
+			autoTriggered = true
+			setFetchNonce(1)
+			return
+		}
+
+		if (fetchN === 0 && refreshN === 0) {
+			return
+		}
+
+		let cancelled = false
+		const isNewFetch = fetchN > lastHandledFetchNonce
+		const isNewRefresh = refreshN > lastHandledRefreshNonce
+		const force = isNewRefresh
+
+		if (!isNewFetch && !isNewRefresh) {
+			if (timeback) {
+				const cached = getProfileCache(timeback)
+
+				if (cached) {
+					setState({ status: 'loaded', profile: cached })
+					onCleanup(() => {
+						cancelled = true
+					})
+
+					return
+				}
+			}
+			return
+		}
+
+		if (timeback && !force) {
+			const cached = getProfileCache(timeback)
+
+			if (cached) {
+				setState({ status: 'loaded', profile: cached })
+				lastHandledFetchNonce = fetchN
+				onCleanup(() => {
+					cancelled = true
+				})
+
+				return
+			}
+		}
+
+		setState({ status: 'loading' })
+
+		void (async () => {
+			try {
+				if (!timeback) {
+					return
+				}
+
+				lastHandledFetchNonce = fetchN
+				lastHandledRefreshNonce = refreshN
+
+				const profile = await fetchProfileOnce(timeback, force)
+
+				if (cancelled) {
+					return
+				}
+
+				setState({ status: 'loaded', profile })
+			} catch (err) {
+				if (!cancelled) {
+					setState({
+						status: 'error',
+						message: err instanceof Error ? err.message : 'Failed to fetch profile',
+					})
+				}
+			}
+		})()
+
+		onCleanup(() => {
+			cancelled = true
+		})
+	})
+
+	return {
+		get state() {
+			return state()
+		},
+		get canFetch() {
+			return canFetch()
+		},
+		fetchProfile,
+		refresh,
+	}
+}