@timeback/sdk 0.1.8 → 0.1.10

package/dist/server/namespaces/activity/record.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Activity Record
+ *
+ * Server-side activity recording API implementation.
+ * Allows apps to submit activity completions directly from their backend.
+ */
+import { recordCompletion as recordCompletionImpl, sendTimeSpent as sendTimeSpentImpl } from '../../handlers/activity/submit';
+import type { TimebackClient } from '@timeback/core';
+import type { ActivityRecordInput, ApiCredentials, AppConfig, Environment, TimebackConfig } from '../../types';
+/**
+ * Error thrown when activity record validation fails.
+ */
+export declare class ActivityRecordValidationError extends Error {
+    readonly code: "VALIDATION_ERROR";
+    readonly details: unknown;
+    constructor(message: string, details: unknown);
+}
+/**
+ * Error thrown when course resolution fails.
+ */
+export declare class ActivityRecordCourseError extends Error {
+    readonly code: "COURSE_ERROR";
+    constructor(message: string);
+}
+/**
+ * Configuration for creating the record function (internal).
+ */
+interface ActivityRecordConfig {
+    env: Environment;
+    api: ApiCredentials;
+    appConfig: AppConfig;
+    /** Get the shared Timeback API client. */
+    getClient: () => TimebackClient;
+    hooks?: TimebackConfig['hooks'];
+}
+interface ActivityRecordDeps {
+    recordCompletion: typeof recordCompletionImpl;
+    sendTimeSpent: typeof sendTimeSpentImpl;
+}
+/**
+ * Create the activity record function.
+ *
+ * @param config - Record configuration
+ * @param deps - Internal dependencies (for testing)
+ * @returns The record function
+ */
+export declare function createActivityRecord(config: ActivityRecordConfig, deps?: ActivityRecordDeps): (input: ActivityRecordInput) => Promise<void>;
+export {};
+//# sourceMappingURL=record.d.ts.map

package/dist/server/namespaces/activity/record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../../../src/server/namespaces/activity/record.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EACN,gBAAgB,IAAI,oBAAoB,EACxC,aAAa,IAAI,iBAAiB,EAClC,MAAM,gCAAgC,CAAA;AAKvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,KAAK,EACX,mBAAmB,EACnB,cAAc,EACd,SAAS,EACT,WAAW,EACX,cAAc,EACd,MAAM,aAAa,CAAA;AAQpB;;GAEG;AACH,qBAAa,6BAA8B,SAAQ,KAAK;IACvD,QAAQ,CAAC,IAAI,qBAA8B;IAC3C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IAEzB,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAI5C;CACD;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;IACnD,QAAQ,CAAC,IAAI,iBAA0B;IAEvC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACD;AAkJD;;GAEG;AACH,UAAU,oBAAoB;IAC7B,GAAG,EAAE,WAAW,CAAA;IAChB,GAAG,EAAE,cAAc,CAAA;IACnB,SAAS,EAAE,SAAS,CAAA;IACpB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,cAAc,CAAA;IAC/B,KAAK,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAA;CAC/B;AAED,UAAU,kBAAkB;IAC3B,gBAAgB,EAAE,OAAO,oBAAoB,CAAA;IAC7C,aAAa,EAAE,OAAO,iBAAiB,CAAA;CACvC;AAWD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,oBAAoB,EAC5B,IAAI,GAAE,kBAAgC,GACpC,CAAC,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAkE/C"}

package/dist/server/namespaces/activity/schema.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Activity Record Schema
+ *
+ * Zod schemas for validating `timeback.activity.record()` inputs.
+ */
+import * as z from 'zod';
+export declare const runIdSchema: z.ZodOptional<z.ZodUUID>;
+/** Schema for `timeback.activity.record()` input. */
+export declare const activityRecordInputSchema: z.ZodObject<{
+    user: z.ZodObject<{
+        email: z.ZodEmail;
+        timebackId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    activity: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        course: z.ZodUnion<readonly [z.ZodObject<{
+            subject: z.ZodEnum<{
+                FastMath: "FastMath";
+                Language: "Language";
+                Math: "Math";
+                None: "None";
+                Other: "Other";
+                Reading: "Reading";
+                Science: "Science";
+                "Social Studies": "Social Studies";
+                Vocabulary: "Vocabulary";
+                Writing: "Writing";
+            }>;
+            grade: z.ZodUnion<readonly [z.ZodLiteral<-1>, z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>, z.ZodLiteral<6>, z.ZodLiteral<7>, z.ZodLiteral<8>, z.ZodLiteral<9>, z.ZodLiteral<10>, z.ZodLiteral<11>, z.ZodLiteral<12>, z.ZodLiteral<13>]>;
+        }, z.core.$strip>, z.ZodObject<{
+            code: z.ZodString;
+        }, z.core.$strip>]>;
+    }, z.core.$strip>;
+    metrics: z.ZodObject<{
+        totalQuestions: z.ZodOptional<z.ZodNumber>;
+        correctQuestions: z.ZodOptional<z.ZodNumber>;
+        xpEarned: z.ZodNumber;
+        masteredUnits: z.ZodOptional<z.ZodNumber>;
+        pctComplete: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    time: z.ZodOptional<z.ZodObject<{
+        startedAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodDate]>>;
+        endedAt: z.ZodOptional<z.ZodUnion<readonly [z.ZodISODateTime, z.ZodDate]>>;
+        activeMs: z.ZodOptional<z.ZodNumber>;
+        inactiveMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    runId: z.ZodOptional<z.ZodUUID>;
+}, z.core.$strip>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/server/namespaces/activity/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/server/namespaces/activity/schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAkCxB,eAAO,MAAM,WAAW,0BAAsB,CAAA;AAM9C,qDAAqD;AACrD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMpC,CAAA"}

package/dist/server/namespaces/user/get-profile.d.ts

@@ -0,0 +1,32 @@
+/**
+ * User Get Profile
+ *
+ * Server-side user profile API implementation.
+ * Programmatic equivalent of the `/user/me` HTTP handler.
+ */
+import type { TimebackProfile } from '../../../shared/types';
+import type { TimebackClient } from '@timeback/core';
+import type { ApiCredentials, AppConfig, Environment } from '../../types';
+/**
+ * Configuration for creating the getProfile function (internal).
+ */
+interface UserGetProfileConfig {
+    env: Environment;
+    api: ApiCredentials;
+    appConfig: AppConfig;
+    /** Get the shared Timeback API client. */
+    getClient: () => TimebackClient;
+}
+/**
+ * Create the user getProfile function.
+ *
+ * Returns the full enriched `TimebackProfile` (identity, enrollments, courses,
+ * goals, XP) for a given email. This is the programmatic equivalent of the
+ * `/user/me` HTTP handler.
+ *
+ * @param config - GetProfile configuration
+ * @returns The getProfile function
+ */
+export declare function createUserGetProfile(config: UserGetProfileConfig): (email: string) => Promise<TimebackProfile>;
+export {};
+//# sourceMappingURL=get-profile.d.ts.map

package/dist/server/namespaces/user/get-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-profile.d.ts","sourceRoot":"","sources":["../../../../src/server/namespaces/user/get-profile.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAQzE;;GAEG;AACH,UAAU,oBAAoB;IAC7B,GAAG,EAAE,WAAW,CAAA;IAChB,GAAG,EAAE,cAAc,CAAA;IACnB,SAAS,EAAE,SAAS,CAAA;IACpB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,cAAc,CAAA;CAC/B;AAMD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,oBAAoB,GAC1B,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CA6B7C"}

package/dist/server/namespaces/user/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * User Namespace
+ *
+ * Server-side user operations.
+ */
+export { createUserVerify } from './verify';
+export { createUserGetProfile } from './get-profile';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/namespaces/user/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA"}

package/dist/server/namespaces/user/verify.d.ts

@@ -0,0 +1,28 @@
+/**
+ * User Verify
+ *
+ * Server-side user verification API implementation.
+ * Programmatic equivalent of the `/user/verify` HTTP handler.
+ */
+import type { TimebackClient } from '@timeback/core';
+import type { TimebackVerifyResult } from '../../../shared/types';
+/**
+ * Configuration for creating the verify function (internal).
+ */
+interface UserVerifyConfig {
+    /** Get the shared Timeback API client. */
+    getClient: () => TimebackClient;
+}
+/**
+ * Create the user verify function.
+ *
+ * Checks whether a Timeback user exists for the given email without
+ * building the full enriched profile. This is the programmatic equivalent
+ * of the `/user/verify` HTTP handler.
+ *
+ * @param config - Verify configuration
+ * @returns The verify function
+ */
+export declare function createUserVerify(config: UserVerifyConfig): (email: string) => Promise<TimebackVerifyResult>;
+export {};
+//# sourceMappingURL=verify.d.ts.map

package/dist/server/namespaces/user/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../../../src/server/namespaces/user/verify.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAQjE;;GAEG;AACH,UAAU,gBAAgB;IACzB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,cAAc,CAAA;CAC/B;AAMD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC/B,MAAM,EAAE,gBAAgB,GACtB,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,CA6BlD"}

package/dist/server/timeback.d.ts

@@ -7,7 +7,7 @@ import type { TimebackConfig, TimebackInstance } from './types';
 /**
  * Create a Timeback server instance.
  *
- * Returns a framework-agnostic instance with raw handlers.
+ * Returns an instance with raw handlers.
  *
  * Use an adapter to integrate with your framework:
  * - `toNextjsHandler()` for Next.js App Router
@@ -33,8 +33,8 @@ import type { TimebackConfig, TimebackInstance } from './types';
  *   },
  *   identity: {
  *     mode: 'sso',
- *     clientId: process.env.AWS_COGNITO_CLIENT_ID!,
- *     clientSecret: process.env.AWS_COGNITO_CLIENT_SECRET!,
+ *     clientId: process.env.TIMEBACK_SSO_CLIENT_ID!,
+ *     clientSecret: process.env.TIMEBACK_SSO_CLIENT_SECRET!,
  *     onCallbackSuccess: async ({ user, state, redirect }) => {
  *       // user.id is the timebackId (canonical stable identifier)
  *       await setSession({ id: user.id, email: user.email })

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

@@ -1 +1 @@
-{"version":3,"file":"timeback.d.ts","sourceRoot":"","sources":["../../src/server/timeback.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,OAAO,KAAK,EAAa,cAAc,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAyC1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,wBAAsB,cAAc,CAAC,MAAM,GAAG,OAAO,EACpD,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,GAC5B,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAiFnC"}
+{"version":3,"file":"timeback.d.ts","sourceRoot":"","sources":["../../src/server/timeback.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiBH,OAAO,KAAK,EAA0B,cAAc,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAyCvF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,wBAAsB,cAAc,CAAC,MAAM,GAAG,OAAO,EACpD,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,GAC5B,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CA6FnC"}