@headless-lms/server 0.1.0

package/dist/http/schemas/learn.d.ts

@@ -0,0 +1,142 @@
+import { z } from "zod";
+//#region src/http/schemas/learn.d.ts
+/** Courses the authenticated student is actively enrolled in (published only). */
+declare const LearnCourses: z.ZodArray<z.ZodObject<{
+  orgId: z.ZodString;
+  id: z.ZodString;
+  type: z.ZodLiteral<"course">;
+  title: z.ZodString;
+  slug: z.ZodString;
+  description: z.ZodString;
+  status: z.ZodEnum<{
+    draft: "draft";
+    published: "published";
+  }>;
+  category: z.ZodString;
+  thumbnailAssetId: z.ZodNullable<z.ZodString>;
+  settings: z.ZodType<import("@headless-lms/core/types").JsonValue, unknown, z.core.$ZodTypeInternals<import("@headless-lms/core/types").JsonValue, unknown>>;
+  createdAt: z.ZodCoercedDate<unknown>;
+  updatedAt: z.ZodCoercedDate<unknown>;
+}, z.core.$strict>>;
+type LearnCourses = z.infer<typeof LearnCourses>;
+/** One enrolled course's module→activity tree (published activities only). */
+declare const LearnModules: z.ZodArray<z.ZodObject<{
+  orgId: z.ZodString;
+  id: z.ZodString;
+  courseId: z.ZodString;
+  title: z.ZodString;
+  seq: z.ZodNumber;
+  createdAt: z.ZodCoercedDate<unknown>;
+  updatedAt: z.ZodCoercedDate<unknown>;
+}, z.core.$strict>>;
+type LearnModules = z.infer<typeof LearnModules>;
+declare const LearnCourseIdParam: z.ZodObject<{
+  courseId: z.ZodString;
+}, z.core.$strip>;
+type LearnCourseIdParam = z.infer<typeof LearnCourseIdParam>;
+/** Downloads the authenticated student is actively entitled to (published only). */
+declare const LearnDownloads: z.ZodArray<z.ZodObject<{
+  orgId: z.ZodString;
+  id: z.ZodString;
+  type: z.ZodLiteral<"download">;
+  title: z.ZodString;
+  slug: z.ZodString;
+  description: z.ZodString;
+  status: z.ZodEnum<{
+    draft: "draft";
+    published: "published";
+  }>;
+  category: z.ZodString;
+  thumbnailAssetId: z.ZodNullable<z.ZodString>;
+  createdAt: z.ZodCoercedDate<unknown>;
+  updatedAt: z.ZodCoercedDate<unknown>;
+}, z.core.$strict>>;
+type LearnDownloads = z.infer<typeof LearnDownloads>;
+/** One entitled download plus its ordered assets. */
+declare const LearnDownload: z.ZodObject<{
+  download: z.ZodObject<{
+    orgId: z.ZodString;
+    id: z.ZodString;
+    type: z.ZodLiteral<"download">;
+    title: z.ZodString;
+    slug: z.ZodString;
+    description: z.ZodString;
+    status: z.ZodEnum<{
+      draft: "draft";
+      published: "published";
+    }>;
+    category: z.ZodString;
+    thumbnailAssetId: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodCoercedDate<unknown>;
+    updatedAt: z.ZodCoercedDate<unknown>;
+  }, z.core.$strict>;
+  assets: z.ZodArray<z.ZodObject<{
+    orgId: z.ZodString;
+    id: z.ZodString;
+    downloadId: z.ZodString;
+    assetId: z.ZodString;
+    seq: z.ZodNumber;
+    displayName: z.ZodNullable<z.ZodString>;
+  }, z.core.$strict>>;
+}, z.core.$strip>;
+type LearnDownload = z.infer<typeof LearnDownload>;
+/** The portal org's public identity — the student surface themes against it. */
+declare const LearnOrg: z.ZodObject<{
+  id: z.ZodString;
+  name: z.ZodString;
+  slug: z.ZodString;
+}, z.core.$strip>;
+type LearnOrg = z.infer<typeof LearnOrg>;
+/** Who the caller is within the session's org. The session cookie identifies
+ *  an auth user; the learner surface is keyed on `org_users.id`. */
+declare const LearnViewer: z.ZodObject<{
+  orgUserId: z.ZodString;
+  role: z.ZodEnum<{
+    owner: "owner";
+    admin: "admin";
+    instructor: "instructor";
+    student: "student";
+  }>;
+}, z.core.$strip>;
+type LearnViewer = z.infer<typeof LearnViewer>;
+/** One reported fact — never a decision. `asset` names the subject within the
+ *  activity (absent = the activity itself); `completed` is the learner's
+ *  activity-level claim. Every other field is the asset type's own vocabulary,
+ *  passed through opaquely. */
+declare const ProgressReportItem: z.ZodObject<{
+  asset: z.ZodOptional<z.ZodString>;
+  completed: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$catchall<z.ZodType<import("@headless-lms/core/types").JsonValue, unknown, z.core.$ZodTypeInternals<import("@headless-lms/core/types").JsonValue, unknown>>>>;
+type ProgressReportItem = z.infer<typeof ProgressReportItem>;
+/** The report envelope: the target (key names the content type) and a batch of
+ *  items. `[]` is a bare touch — it creates the record. */
+declare const ReportProgress: z.ZodObject<{
+  activity: z.ZodString;
+  reports: z.ZodArray<z.ZodObject<{
+    asset: z.ZodOptional<z.ZodString>;
+    completed: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$catchall<z.ZodType<import("@headless-lms/core/types").JsonValue, unknown, z.core.$ZodTypeInternals<import("@headless-lms/core/types").JsonValue, unknown>>>>>;
+}, z.core.$strip>;
+type ReportProgress = z.infer<typeof ReportProgress>;
+/** The reported target's state after the service decided. */
+declare const ProgressStatus: z.ZodObject<{
+  status: z.ZodEnum<{
+    completed: "completed";
+    "in-progress": "in-progress";
+  }>;
+}, z.core.$strip>;
+type ProgressStatus = z.infer<typeof ProgressStatus>;
+/** Per-course progress, derived on read against current structure. */
+declare const CourseProgress: z.ZodObject<{
+  activities: z.ZodRecord<z.ZodString, z.ZodEnum<{
+    completed: "completed";
+    "in-progress": "in-progress";
+  }>>;
+  percent: z.ZodInt;
+  completed: z.ZodBoolean;
+  positions: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+type CourseProgress = z.infer<typeof CourseProgress>;
+//#endregion
+export { CourseProgress, LearnCourseIdParam, LearnCourses, LearnDownload, LearnDownloads, LearnModules, LearnOrg, LearnViewer, ProgressReportItem, ProgressStatus, ReportProgress };
+//# sourceMappingURL=learn.d.ts.map

package/dist/http/schemas/learn.js

@@ -0,0 +1,58 @@
+import { OrgRole } from "./shared.js";
+import { Course } from "./content.js";
+import { Download, DownloadAsset } from "./downloads.js";
+import { Module } from "./activities.js";
+import { z } from "zod";
+import { progressReportItemSchema } from "@headless-lms/core/schemas";
+//#region src/http/schemas/learn.ts
+/** Courses the authenticated student is actively enrolled in (published only). */
+const LearnCourses = z.array(Course);
+/** One enrolled course's module→activity tree (published activities only). */
+const LearnModules = z.array(Module);
+const LearnCourseIdParam = z.object({ courseId: z.string() });
+/** Downloads the authenticated student is actively entitled to (published only). */
+const LearnDownloads = z.array(Download);
+/** One entitled download plus its ordered assets. */
+const LearnDownload = z.object({
+	download: Download,
+	assets: z.array(DownloadAsset)
+});
+/** The portal org's public identity — the student surface themes against it. */
+const LearnOrg = z.object({
+	id: z.string(),
+	name: z.string(),
+	slug: z.string()
+});
+/** Who the caller is within the session's org. The session cookie identifies
+*  an auth user; the learner surface is keyed on `org_users.id`. */
+const LearnViewer = z.object({
+	orgUserId: z.string(),
+	role: OrgRole
+});
+/** One reported fact — never a decision. `asset` names the subject within the
+*  activity (absent = the activity itself); `completed` is the learner's
+*  activity-level claim. Every other field is the asset type's own vocabulary,
+*  passed through opaquely. */
+const ProgressReportItem = progressReportItemSchema;
+/** The report envelope: the target (key names the content type) and a batch of
+*  items. `[]` is a bare touch — it creates the record. */
+const ReportProgress = z.object({
+	activity: z.string(),
+	reports: z.array(ProgressReportItem)
+});
+/** The reported target's state after the service decided. */
+const ProgressStatus = z.object({ status: z.enum(["in-progress", "completed"]) });
+/** Per-course progress, derived on read against current structure. */
+const CourseProgress = z.object({
+	/** Keyed by activity id; absent key = not started. */
+	activities: z.record(z.string(), z.enum(["in-progress", "completed"])),
+	/** Integer 0–100, completed ÷ current activities, rounded. */
+	percent: z.int().min(0).max(100),
+	completed: z.boolean(),
+	/** Keyed by activity id: the per-asset reported state map (opaque). */
+	positions: z.record(z.string(), z.unknown())
+});
+//#endregion
+export { CourseProgress, LearnCourseIdParam, LearnCourses, LearnDownload, LearnDownloads, LearnModules, LearnOrg, LearnViewer, ProgressReportItem, ProgressStatus, ReportProgress };
+
+//# sourceMappingURL=learn.js.map

package/dist/http/schemas/learn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"learn.js","names":[],"sources":["../../../src/http/schemas/learn.ts"],"sourcesContent":["// Learn resource schemas — the student-facing read surface. Reuses the Course\n// and Module payloads (identical wire shape to the back-office API, including\n// the opaque activity `settings` blob) so one renderer path serves both.\nimport { z } from \"zod\";\nimport { progressReportItemSchema } from \"@headless-lms/core/schemas\";\nimport { Course } from \"./content.js\";\nimport { Module } from \"./activities.js\";\nimport { Download, DownloadAsset } from \"./downloads.js\";\nimport { OrgRole } from \"./shared.js\";\n\n/** Courses the authenticated student is actively enrolled in (published only). */\nexport const LearnCourses = z.array(Course);\nexport type LearnCourses = z.infer<typeof LearnCourses>;\n\n/** One enrolled course's module→activity tree (published activities only). */\nexport const LearnModules = z.array(Module);\nexport type LearnModules = z.infer<typeof LearnModules>;\n\nexport const LearnCourseIdParam = z.object({ courseId: z.string() });\nexport type LearnCourseIdParam = z.infer<typeof LearnCourseIdParam>;\n\n/** Downloads the authenticated student is actively entitled to (published only). */\nexport const LearnDownloads = z.array(Download);\nexport type LearnDownloads = z.infer<typeof LearnDownloads>;\n\n/** One entitled download plus its ordered assets. */\nexport const LearnDownload = z.object({\n  download: Download,\n  assets: z.array(DownloadAsset),\n});\nexport type LearnDownload = z.infer<typeof LearnDownload>;\n\n/** The portal org's public identity — the student surface themes against it. */\nexport const LearnOrg = z.object({\n  id: z.string(),\n  name: z.string(),\n  slug: z.string(),\n});\nexport type LearnOrg = z.infer<typeof LearnOrg>;\n\n/** Who the caller is within the session's org. The session cookie identifies\n *  an auth user; the learner surface is keyed on `org_users.id`. */\nexport const LearnViewer = z.object({\n  orgUserId: z.string(),\n  role: OrgRole,\n});\nexport type LearnViewer = z.infer<typeof LearnViewer>;\n\n/** One reported fact — never a decision. `asset` names the subject within the\n *  activity (absent = the activity itself); `completed` is the learner's\n *  activity-level claim. Every other field is the asset type's own vocabulary,\n *  passed through opaquely. */\nexport const ProgressReportItem = progressReportItemSchema;\nexport type ProgressReportItem = z.infer<typeof ProgressReportItem>;\n\n/** The report envelope: the target (key names the content type) and a batch of\n *  items. `[]` is a bare touch — it creates the record. */\nexport const ReportProgress = z.object({\n  activity: z.string(),\n  reports: z.array(ProgressReportItem),\n});\nexport type ReportProgress = z.infer<typeof ReportProgress>;\n\n/** The reported target's state after the service decided. */\nexport const ProgressStatus = z.object({\n  status: z.enum([\"in-progress\", \"completed\"]),\n});\nexport type ProgressStatus = z.infer<typeof ProgressStatus>;\n\n/** Per-course progress, derived on read against current structure. */\nexport const CourseProgress = z.object({\n  /** Keyed by activity id; absent key = not started. */\n  activities: z.record(z.string(), z.enum([\"in-progress\", \"completed\"])),\n  /** Integer 0–100, completed ÷ current activities, rounded. */\n  percent: z.int().min(0).max(100),\n  completed: z.boolean(),\n  /** Keyed by activity id: the per-asset reported state map (opaque). */\n  positions: z.record(z.string(), z.unknown()),\n});\nexport type CourseProgress = z.infer<typeof CourseProgress>;\n\n"],"mappings":";;;;;;;;AAWA,MAAa,eAAe,EAAE,MAAM,MAAM;;AAI1C,MAAa,eAAe,EAAE,MAAM,MAAM;AAG1C,MAAa,qBAAqB,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;;AAInE,MAAa,iBAAiB,EAAE,MAAM,QAAQ;;AAI9C,MAAa,gBAAgB,EAAE,OAAO;CACpC,UAAU;CACV,QAAQ,EAAE,MAAM,aAAa;AAC/B,CAAC;;AAID,MAAa,WAAW,EAAE,OAAO;CAC/B,IAAI,EAAE,OAAO;CACb,MAAM,EAAE,OAAO;CACf,MAAM,EAAE,OAAO;AACjB,CAAC;;;AAKD,MAAa,cAAc,EAAE,OAAO;CAClC,WAAW,EAAE,OAAO;CACpB,MAAM;AACR,CAAC;;;;;AAOD,MAAa,qBAAqB;;;AAKlC,MAAa,iBAAiB,EAAE,OAAO;CACrC,UAAU,EAAE,OAAO;CACnB,SAAS,EAAE,MAAM,kBAAkB;AACrC,CAAC;;AAID,MAAa,iBAAiB,EAAE,OAAO,EACrC,QAAQ,EAAE,KAAK,CAAC,eAAe,WAAW,CAAC,EAC7C,CAAC;;AAID,MAAa,iBAAiB,EAAE,OAAO;;CAErC,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,KAAK,CAAC,eAAe,WAAW,CAAC,CAAC;;CAErE,SAAS,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG;CAC/B,WAAW,EAAE,QAAQ;;CAErB,WAAW,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC;AAC7C,CAAC"}

package/dist/http/schemas/members.d.ts

@@ -0,0 +1,88 @@
+import { z } from "zod";
+//#region src/http/schemas/members.d.ts
+/** Org-scoped roles, mirrored from better-auth's organization plugin. */
+declare const Role: z.ZodEnum<{
+  owner: "owner";
+  admin: "admin";
+  instructor: "instructor";
+}>;
+type Role = z.infer<typeof Role>;
+declare const MemberStatus: z.ZodEnum<{
+  active: "active";
+  invited: "invited";
+}>;
+type MemberStatus = z.infer<typeof MemberStatus>;
+declare const Member: z.ZodObject<{
+  id: z.ZodString;
+  firstName: z.ZodNullable<z.ZodString>;
+  lastName: z.ZodNullable<z.ZodString>;
+  email: z.ZodString;
+  image: z.ZodNullable<z.ZodString>;
+  role: z.ZodEnum<{
+    owner: "owner";
+    admin: "admin";
+    instructor: "instructor";
+  }>;
+  status: z.ZodEnum<{
+    active: "active";
+    invited: "invited";
+  }>;
+  joinedAt: z.ZodNullable<z.ZodString>;
+  invitedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+type Member = z.infer<typeof Member>;
+declare const MembersQuery: z.ZodObject<{
+  page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+  pageSize: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+  search: z.ZodOptional<z.ZodString>;
+  sort: z.ZodOptional<z.ZodString>;
+  role: z.ZodOptional<z.ZodEnum<{
+    owner: "owner";
+    admin: "admin";
+    instructor: "instructor";
+  }>>;
+  status: z.ZodOptional<z.ZodEnum<{
+    active: "active";
+    invited: "invited";
+  }>>;
+}, z.core.$strip>;
+type MembersQuery = z.infer<typeof MembersQuery>;
+declare const MembersPage: z.ZodObject<{
+  rows: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    firstName: z.ZodNullable<z.ZodString>;
+    lastName: z.ZodNullable<z.ZodString>;
+    email: z.ZodString;
+    image: z.ZodNullable<z.ZodString>;
+    role: z.ZodEnum<{
+      owner: "owner";
+      admin: "admin";
+      instructor: "instructor";
+    }>;
+    status: z.ZodEnum<{
+      active: "active";
+      invited: "invited";
+    }>;
+    joinedAt: z.ZodNullable<z.ZodString>;
+    invitedAt: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>;
+  total: z.ZodNumber;
+  page: z.ZodNumber;
+  pageSize: z.ZodNumber;
+}, z.core.$strip>;
+type MembersPage = z.infer<typeof MembersPage>;
+declare const UpdateMemberRole: z.ZodObject<{
+  role: z.ZodEnum<{
+    owner: "owner";
+    admin: "admin";
+    instructor: "instructor";
+  }>;
+}, z.core.$strip>;
+type UpdateMemberRole = z.infer<typeof UpdateMemberRole>;
+declare const MemberIdParam: z.ZodObject<{
+  id: z.ZodString;
+}, z.core.$strip>;
+type MemberIdParam = z.infer<typeof MemberIdParam>;
+//#endregion
+export { Member, MemberIdParam, MemberStatus, MembersPage, MembersQuery, Role, UpdateMemberRole };
+//# sourceMappingURL=members.d.ts.map

package/dist/http/schemas/members.js

@@ -0,0 +1,27 @@
+import { ListQuery, OrgUserProfileSchema, paginated } from "./shared.js";
+import { z } from "zod";
+//#region src/http/schemas/members.ts
+/** Org-scoped roles, mirrored from better-auth's organization plugin. */
+const Role = z.enum([
+	"owner",
+	"admin",
+	"instructor"
+]);
+const MemberStatus = z.enum(["active", "invited"]);
+const Member = OrgUserProfileSchema.extend({
+	role: Role,
+	status: MemberStatus,
+	joinedAt: z.string().nullable(),
+	invitedAt: z.string().nullable()
+});
+const MembersQuery = ListQuery.extend({
+	role: Role.optional(),
+	status: MemberStatus.optional()
+});
+const MembersPage = paginated(Member);
+const UpdateMemberRole = z.object({ role: Role });
+const MemberIdParam = z.object({ id: z.string() });
+//#endregion
+export { Member, MemberIdParam, MemberStatus, MembersPage, MembersQuery, Role, UpdateMemberRole };
+
+//# sourceMappingURL=members.js.map

package/dist/http/schemas/members.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"members.js","names":[],"sources":["../../../src/http/schemas/members.ts"],"sourcesContent":["// Team (org members) resource schemas.\nimport { z } from \"zod\";\nimport { ListQuery, paginated, OrgUserProfileSchema } from \"./shared.js\";\n\n/** Org-scoped roles, mirrored from better-auth's organization plugin. */\nexport const Role = z.enum([\"owner\", \"admin\", \"instructor\"]);\nexport type Role = z.infer<typeof Role>;\n\nexport const MemberStatus = z.enum([\"active\", \"invited\"]);\nexport type MemberStatus = z.infer<typeof MemberStatus>;\n\nexport const Member = OrgUserProfileSchema.extend({\n  role: Role,\n  status: MemberStatus,\n  joinedAt: z.string().nullable(),\n  invitedAt: z.string().nullable(),\n});\nexport type Member = z.infer<typeof Member>;\n\nexport const MembersQuery = ListQuery.extend({\n  role: Role.optional(),\n  status: MemberStatus.optional(),\n});\nexport type MembersQuery = z.infer<typeof MembersQuery>;\n\nexport const MembersPage = paginated(Member);\nexport type MembersPage = z.infer<typeof MembersPage>;\n\nexport const UpdateMemberRole = z.object({ role: Role });\nexport type UpdateMemberRole = z.infer<typeof UpdateMemberRole>;\n\nexport const MemberIdParam = z.object({ id: z.string() });\nexport type MemberIdParam = z.infer<typeof MemberIdParam>;\n"],"mappings":";;;;AAKA,MAAa,OAAO,EAAE,KAAK;CAAC;CAAS;CAAS;AAAY,CAAC;AAG3D,MAAa,eAAe,EAAE,KAAK,CAAC,UAAU,SAAS,CAAC;AAGxD,MAAa,SAAS,qBAAqB,OAAO;CAChD,MAAM;CACN,QAAQ;CACR,UAAU,EAAE,OAAO,CAAC,CAAC,SAAS;CAC9B,WAAW,EAAE,OAAO,CAAC,CAAC,SAAS;AACjC,CAAC;AAGD,MAAa,eAAe,UAAU,OAAO;CAC3C,MAAM,KAAK,SAAS;CACpB,QAAQ,aAAa,SAAS;AAChC,CAAC;AAGD,MAAa,cAAc,UAAU,MAAM;AAG3C,MAAa,mBAAmB,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAGvD,MAAa,gBAAgB,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}

package/dist/http/schemas/organizations.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+//#region src/http/schemas/organizations.d.ts
+declare const Organization: z.ZodObject<{
+  id: z.ZodString;
+  name: z.ZodString;
+  slug: z.ZodString;
+  createdAt: z.ZodString;
+}, z.core.$strip>;
+type Organization = z.infer<typeof Organization>;
+declare const CreateOrganization: z.ZodObject<{
+  name: z.ZodString;
+  slug: z.ZodString;
+}, z.core.$strip>;
+type CreateOrganization = z.infer<typeof CreateOrganization>;
+declare const UpdateOrganization: z.ZodObject<{
+  name: z.ZodString;
+  slug: z.ZodString;
+}, z.core.$strip>;
+type UpdateOrganization = z.infer<typeof UpdateOrganization>;
+//#endregion
+export { CreateOrganization, Organization, UpdateOrganization };
+//# sourceMappingURL=organizations.d.ts.map

package/dist/http/schemas/organizations.js

@@ -0,0 +1,20 @@
+import { z } from "zod";
+//#region src/http/schemas/organizations.ts
+const Organization = z.object({
+	id: z.string(),
+	name: z.string(),
+	slug: z.string(),
+	createdAt: z.string()
+});
+const CreateOrganization = z.object({
+	name: z.string().min(1),
+	slug: z.string().min(1)
+});
+const UpdateOrganization = z.object({
+	name: z.string().min(1).max(100),
+	slug: z.string().min(1).max(50).regex(/^[a-z0-9-]+$/, "Use lowercase letters, numbers, and hyphens only")
+});
+//#endregion
+export { CreateOrganization, Organization, UpdateOrganization };
+
+//# sourceMappingURL=organizations.js.map

package/dist/http/schemas/organizations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"organizations.js","names":[],"sources":["../../../src/http/schemas/organizations.ts"],"sourcesContent":["// Organization resource schemas. Org creation is served by the API's own\n// `/api/organizations` route (which drives Better Auth under the hood), so the\n// created org is part of the typed contract and SDK — not the auth namespace.\nimport { z } from \"zod\";\n\nexport const Organization = z.object({\n  id: z.string(),\n  name: z.string(),\n  slug: z.string(),\n  createdAt: z.string(),\n});\nexport type Organization = z.infer<typeof Organization>;\n\nexport const CreateOrganization = z.object({\n  name: z.string().min(1),\n  slug: z.string().min(1),\n});\nexport type CreateOrganization = z.infer<typeof CreateOrganization>;\n\n// Update the active organization's profile. Slug must stay URL-safe (Better Auth\n// enforces uniqueness); both fields are sent together from the settings form.\nexport const UpdateOrganization = z.object({\n  name: z.string().min(1).max(100),\n  slug: z\n    .string()\n    .min(1)\n    .max(50)\n    .regex(/^[a-z0-9-]+$/, \"Use lowercase letters, numbers, and hyphens only\"),\n});\nexport type UpdateOrganization = z.infer<typeof UpdateOrganization>;\n"],"mappings":";;AAKA,MAAa,eAAe,EAAE,OAAO;CACnC,IAAI,EAAE,OAAO;CACb,MAAM,EAAE,OAAO;CACf,MAAM,EAAE,OAAO;CACf,WAAW,EAAE,OAAO;AACtB,CAAC;AAGD,MAAa,qBAAqB,EAAE,OAAO;CACzC,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;CACtB,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;AACxB,CAAC;AAKD,MAAa,qBAAqB,EAAE,OAAO;CACzC,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG;CAC/B,MAAM,EACH,OAAO,CAAC,CACR,IAAI,CAAC,CAAC,CACN,IAAI,EAAE,CAAC,CACP,MAAM,gBAAgB,kDAAkD;AAC7E,CAAC"}

package/dist/http/schemas/settings.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+//#region src/http/schemas/settings.d.ts
+/** A namespace's values. The owning domain defines the shape; the contract
+ *  carries it opaquely so a new namespace needs no contract change. */
+declare const SettingsValue: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+type SettingsValue = z.infer<typeof SettingsValue>;
+declare const ScopeSettings: z.ZodObject<{
+  scopeId: z.ZodString;
+  namespaces: z.ZodRecord<z.ZodString, z.ZodAny>;
+}, z.core.$strip>;
+type ScopeSettings = z.infer<typeof ScopeSettings>;
+declare const SettingsScopeParam: z.ZodObject<{
+  scopeId: z.ZodString;
+}, z.core.$strip>;
+declare const SettingsNamespaceParam: z.ZodObject<{
+  scopeId: z.ZodString;
+  namespace: z.ZodString;
+}, z.core.$strip>;
+/** Partial by definition — the server shallow-merges it into the stored value. */
+declare const PatchSettings: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+//#endregion
+export { PatchSettings, ScopeSettings, SettingsNamespaceParam, SettingsScopeParam, SettingsValue };
+//# sourceMappingURL=settings.d.ts.map

package/dist/http/schemas/settings.js

@@ -0,0 +1,20 @@
+import { z } from "zod";
+//#region src/http/schemas/settings.ts
+/** A namespace's values. The owning domain defines the shape; the contract
+*  carries it opaquely so a new namespace needs no contract change. */
+const SettingsValue = z.record(z.string(), z.unknown());
+const ScopeSettings = z.object({
+	scopeId: z.string(),
+	namespaces: z.record(z.string(), z.any())
+});
+const SettingsScopeParam = z.object({ scopeId: z.string() });
+const SettingsNamespaceParam = z.object({
+	scopeId: z.string(),
+	namespace: z.string()
+});
+/** Partial by definition — the server shallow-merges it into the stored value. */
+const PatchSettings = SettingsValue;
+//#endregion
+export { PatchSettings, ScopeSettings, SettingsNamespaceParam, SettingsScopeParam, SettingsValue };
+
+//# sourceMappingURL=settings.js.map

package/dist/http/schemas/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","names":[],"sources":["../../../src/http/schemas/settings.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/** A namespace's values. The owning domain defines the shape; the contract\n *  carries it opaquely so a new namespace needs no contract change. */\nexport const SettingsValue = z.record(z.string(), z.unknown());\nexport type SettingsValue = z.infer<typeof SettingsValue>;\n\n\nexport const ScopeSettings = z.object({\n  scopeId: z.string(),\n  namespaces: z.record(z.string(), z.any()),\n});\nexport type ScopeSettings = z.infer<typeof ScopeSettings>;\n\nexport const SettingsScopeParam = z.object({ scopeId: z.string() });\nexport const SettingsNamespaceParam = z.object({\n  scopeId: z.string(),\n  namespace: z.string(),\n});\n\n/** Partial by definition — the server shallow-merges it into the stored value. */\nexport const PatchSettings = SettingsValue;\n"],"mappings":";;;;AAIA,MAAa,gBAAgB,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC;AAI7D,MAAa,gBAAgB,EAAE,OAAO;CACpC,SAAS,EAAE,OAAO;CAClB,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,IAAI,CAAC;AAC1C,CAAC;AAGD,MAAa,qBAAqB,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;AAClE,MAAa,yBAAyB,EAAE,OAAO;CAC7C,SAAS,EAAE,OAAO;CAClB,WAAW,EAAE,OAAO;AACtB,CAAC;;AAGD,MAAa,gBAAgB"}

package/dist/http/schemas/shared.d.ts

@@ -0,0 +1,57 @@
+import { z } from "zod";
+//#region src/http/schemas/shared.d.ts
+/** Fails typecheck when a schema and its domain type drift apart. */
+type Matches<A, _B extends A> = true;
+/** Uniform error envelope returned by every non-2xx response. */
+declare const ErrorBody: z.ZodObject<{
+  error: z.ZodString;
+  message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type ErrorBody = z.infer<typeof ErrorBody>;
+/**
+ * Common list query for page-based collections. `z.coerce` because query-string
+ * values arrive as strings; defaults make the params optional for callers.
+ */
+declare const ListQuery: z.ZodObject<{
+  page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+  pageSize: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+  search: z.ZodOptional<z.ZodString>;
+  sort: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type ListQuery = z.infer<typeof ListQuery>;
+/** Wrap a row schema into the standard paginated envelope. */
+declare function paginated<T extends z.ZodTypeAny>(row: T): z.ZodObject<{
+  rows: z.ZodArray<T>;
+  total: z.ZodNumber;
+  page: z.ZodNumber;
+  pageSize: z.ZodNumber;
+}, z.core.$strip>;
+/** All four org roles. `members.ts` exports a staff-only three-value `Role`;
+ *  this is the full set, used wherever a learner can also appear. */
+declare const OrgRole: z.ZodEnum<{
+  owner: "owner";
+  admin: "admin";
+  instructor: "instructor";
+  student: "student";
+}>;
+type OrgRole = z.infer<typeof OrgRole>;
+/** Mirrors UserProfile in @headless-lms/core/types — keyed on the auth user id. */
+declare const UserProfileSchema: z.ZodObject<{
+  id: z.ZodString;
+  name: z.ZodString;
+  email: z.ZodString;
+  image: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+type UserProfileSchema = z.infer<typeof UserProfileSchema>;
+/** Mirrors OrgUserProfile in @headless-lms/core/types — keyed on org_users.id. */
+declare const OrgUserProfileSchema: z.ZodObject<{
+  id: z.ZodString;
+  firstName: z.ZodNullable<z.ZodString>;
+  lastName: z.ZodNullable<z.ZodString>;
+  email: z.ZodString;
+  image: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+type OrgUserProfileSchema = z.infer<typeof OrgUserProfileSchema>;
+//#endregion
+export { ErrorBody, ListQuery, Matches, OrgRole, OrgUserProfileSchema, UserProfileSchema, paginated };
+//# sourceMappingURL=shared.d.ts.map

package/dist/http/schemas/shared.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+//#region src/http/schemas/shared.ts
+/** Uniform error envelope returned by every non-2xx response. */
+const ErrorBody = z.object({
+	error: z.string(),
+	message: z.string().optional()
+});
+/**
+* Common list query for page-based collections. `z.coerce` because query-string
+* values arrive as strings; defaults make the params optional for callers.
+*/
+const ListQuery = z.object({
+	page: z.coerce.number().int().min(1).default(1),
+	pageSize: z.coerce.number().int().min(1).max(100).default(20),
+	search: z.string().trim().optional(),
+	/** Sort field, optionally prefixed with `-` for descending (e.g. `-updatedAt`). */
+	sort: z.string().optional()
+});
+/** Wrap a row schema into the standard paginated envelope. */
+function paginated(row) {
+	return z.object({
+		rows: z.array(row),
+		total: z.number().int(),
+		page: z.number().int(),
+		pageSize: z.number().int()
+	});
+}
+/** All four org roles. `members.ts` exports a staff-only three-value `Role`;
+*  this is the full set, used wherever a learner can also appear. */
+const OrgRole = z.enum([
+	"owner",
+	"admin",
+	"instructor",
+	"student"
+]);
+/** Mirrors UserProfile in @headless-lms/core/types — keyed on the auth user id. */
+const UserProfileSchema = z.object({
+	id: z.string(),
+	name: z.string(),
+	email: z.string(),
+	image: z.string().nullable()
+});
+/** Mirrors OrgUserProfile in @headless-lms/core/types — keyed on org_users.id. */
+const OrgUserProfileSchema = z.object({
+	id: z.string(),
+	firstName: z.string().nullable(),
+	lastName: z.string().nullable(),
+	email: z.string(),
+	image: z.string().nullable()
+});
+//#endregion
+export { ErrorBody, ListQuery, OrgRole, OrgUserProfileSchema, UserProfileSchema, paginated };
+
+//# sourceMappingURL=shared.js.map

package/dist/http/schemas/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","names":[],"sources":["../../../src/http/schemas/shared.ts"],"sourcesContent":["// Shared contract primitives reused across resource contracts.\nimport { z } from \"zod\";\n\n/** Fails typecheck when a schema and its domain type drift apart. */\nexport type Matches<A, _B extends A> = true;\n\n/** Uniform error envelope returned by every non-2xx response. */\nexport const ErrorBody = z.object({\n  error: z.string(),\n  message: z.string().optional(),\n});\nexport type ErrorBody = z.infer<typeof ErrorBody>;\n\n/**\n * Common list query for page-based collections. `z.coerce` because query-string\n * values arrive as strings; defaults make the params optional for callers.\n */\nexport const ListQuery = z.object({\n  page: z.coerce.number().int().min(1).default(1),\n  pageSize: z.coerce.number().int().min(1).max(100).default(20),\n  search: z.string().trim().optional(),\n  /** Sort field, optionally prefixed with `-` for descending (e.g. `-updatedAt`). */\n  sort: z.string().optional(),\n});\nexport type ListQuery = z.infer<typeof ListQuery>;\n\n/** Wrap a row schema into the standard paginated envelope. */\nexport function paginated<T extends z.ZodTypeAny>(row: T) {\n  return z.object({\n    rows: z.array(row),\n    total: z.number().int(),\n    page: z.number().int(),\n    pageSize: z.number().int(),\n  });\n}\n\n/** All four org roles. `members.ts` exports a staff-only three-value `Role`;\n *  this is the full set, used wherever a learner can also appear. */\nexport const OrgRole = z.enum([\"owner\", \"admin\", \"instructor\", \"student\"]);\nexport type OrgRole = z.infer<typeof OrgRole>;\n\n/** Mirrors UserProfile in @headless-lms/core/types — keyed on the auth user id. */\nexport const UserProfileSchema = z.object({\n  id: z.string(),\n  name: z.string(),\n  email: z.string(),\n  image: z.string().nullable(),\n});\nexport type UserProfileSchema = z.infer<typeof UserProfileSchema>;\n\n/** Mirrors OrgUserProfile in @headless-lms/core/types — keyed on org_users.id. */\nexport const OrgUserProfileSchema = z.object({\n  id: z.string(),\n  firstName: z.string().nullable(),\n  lastName: z.string().nullable(),\n  email: z.string(),\n  image: z.string().nullable(),\n});\nexport type OrgUserProfileSchema = z.infer<typeof OrgUserProfileSchema>;\n"],"mappings":";;;AAOA,MAAa,YAAY,EAAE,OAAO;CAChC,OAAO,EAAE,OAAO;CAChB,SAAS,EAAE,OAAO,CAAC,CAAC,SAAS;AAC/B,CAAC;;;;;AAOD,MAAa,YAAY,EAAE,OAAO;CAChC,MAAM,EAAE,OAAO,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC;CAC9C,UAAU,EAAE,OAAO,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE;CAC5D,QAAQ,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,SAAS;;CAEnC,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS;AAC5B,CAAC;;AAID,SAAgB,UAAkC,KAAQ;CACxD,OAAO,EAAE,OAAO;EACd,MAAM,EAAE,MAAM,GAAG;EACjB,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI;EACtB,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI;EACrB,UAAU,EAAE,OAAO,CAAC,CAAC,IAAI;CAC3B,CAAC;AACH;;;AAIA,MAAa,UAAU,EAAE,KAAK;CAAC;CAAS;CAAS;CAAc;AAAS,CAAC;;AAIzE,MAAa,oBAAoB,EAAE,OAAO;CACxC,IAAI,EAAE,OAAO;CACb,MAAM,EAAE,OAAO;CACf,OAAO,EAAE,OAAO;CAChB,OAAO,EAAE,OAAO,CAAC,CAAC,SAAS;AAC7B,CAAC;;AAID,MAAa,uBAAuB,EAAE,OAAO;CAC3C,IAAI,EAAE,OAAO;CACb,WAAW,EAAE,OAAO,CAAC,CAAC,SAAS;CAC/B,UAAU,EAAE,OAAO,CAAC,CAAC,SAAS;CAC9B,OAAO,EAAE,OAAO;CAChB,OAAO,EAAE,OAAO,CAAC,CAAC,SAAS;AAC7B,CAAC"}

package/dist/http/schemas/students.d.ts

@@ -0,0 +1,64 @@
+import { z } from "zod";
+//#region src/http/schemas/students.d.ts
+declare const OrgUserStatus: z.ZodEnum<{
+  active: "active";
+  invited: "invited";
+}>;
+type OrgUserStatus = z.infer<typeof OrgUserStatus>;
+declare const Student: z.ZodObject<{
+  id: z.ZodString;
+  firstName: z.ZodNullable<z.ZodString>;
+  lastName: z.ZodNullable<z.ZodString>;
+  email: z.ZodString;
+  image: z.ZodNullable<z.ZodString>;
+  entitlementCount: z.ZodNumber;
+  avgProgress: z.ZodNumber;
+  status: z.ZodEnum<{
+    active: "active";
+    invited: "invited";
+  }>;
+  joinedAt: z.ZodString;
+  lastActiveAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+type Student = z.infer<typeof Student>;
+declare const StudentsQuery: z.ZodObject<{
+  page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+  pageSize: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+  search: z.ZodOptional<z.ZodString>;
+  sort: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type StudentsQuery = z.infer<typeof StudentsQuery>;
+declare const StudentsPage: z.ZodObject<{
+  rows: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    firstName: z.ZodNullable<z.ZodString>;
+    lastName: z.ZodNullable<z.ZodString>;
+    email: z.ZodString;
+    image: z.ZodNullable<z.ZodString>;
+    entitlementCount: z.ZodNumber;
+    avgProgress: z.ZodNumber;
+    status: z.ZodEnum<{
+      active: "active";
+      invited: "invited";
+    }>;
+    joinedAt: z.ZodString;
+    lastActiveAt: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>;
+  total: z.ZodNumber;
+  page: z.ZodNumber;
+  pageSize: z.ZodNumber;
+}, z.core.$strip>;
+type StudentsPage = z.infer<typeof StudentsPage>;
+declare const StudentIdParam: z.ZodObject<{
+  id: z.ZodString;
+}, z.core.$strip>;
+type StudentIdParam = z.infer<typeof StudentIdParam>;
+declare const UpdateStudentBody: z.ZodObject<{
+  firstName: z.ZodString;
+  lastName: z.ZodString;
+  email: z.ZodString;
+}, z.core.$strip>;
+type UpdateStudentBody = z.infer<typeof UpdateStudentBody>;
+//#endregion
+export { OrgUserStatus, Student, StudentIdParam, StudentsPage, StudentsQuery, UpdateStudentBody };
+//# sourceMappingURL=students.d.ts.map

package/dist/http/schemas/students.js

@@ -0,0 +1,25 @@
+import { ListQuery, OrgUserProfileSchema, paginated } from "./shared.js";
+import { z } from "zod";
+//#region src/http/schemas/students.ts
+const OrgUserStatus = z.enum(["invited", "active"]);
+const Student = OrgUserProfileSchema.extend({
+	entitlementCount: z.number().int(),
+	/** 0–100, averaged across active entitlements. */
+	avgProgress: z.number().int(),
+	/** `invited` means an admin added them and they have not accepted yet. */
+	status: OrgUserStatus,
+	joinedAt: z.string(),
+	lastActiveAt: z.string().nullable()
+});
+const StudentsQuery = ListQuery;
+const StudentsPage = paginated(Student);
+const StudentIdParam = z.object({ id: z.string() });
+const UpdateStudentBody = z.object({
+	firstName: z.string().trim().min(1),
+	lastName: z.string().trim().min(1),
+	email: z.string().email()
+});
+//#endregion
+export { OrgUserStatus, Student, StudentIdParam, StudentsPage, StudentsQuery, UpdateStudentBody };
+
+//# sourceMappingURL=students.js.map

package/dist/http/schemas/students.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"students.js","names":[],"sources":["../../../src/http/schemas/students.ts"],"sourcesContent":["// Students resource schemas.\nimport { z } from \"zod\";\nimport { ListQuery, paginated, OrgUserProfileSchema } from \"./shared.js\";\n\nexport const OrgUserStatus = z.enum([\"invited\", \"active\"]);\nexport type OrgUserStatus = z.infer<typeof OrgUserStatus>;\n\nexport const Student = OrgUserProfileSchema.extend({\n  entitlementCount: z.number().int(),\n  /** 0–100, averaged across active entitlements. */\n  avgProgress: z.number().int(),\n  /** `invited` means an admin added them and they have not accepted yet. */\n  status: OrgUserStatus,\n  joinedAt: z.string(),\n  lastActiveAt: z.string().nullable(),\n});\nexport type Student = z.infer<typeof Student>;\n\nexport const StudentsQuery = ListQuery;\nexport type StudentsQuery = z.infer<typeof StudentsQuery>;\n\nexport const StudentsPage = paginated(Student);\nexport type StudentsPage = z.infer<typeof StudentsPage>;\n\nexport const StudentIdParam = z.object({ id: z.string() });\nexport type StudentIdParam = z.infer<typeof StudentIdParam>;\n\n// Every field is a correction to what an admin typed, so all three are sent\n// together — the form edits the whole profile, not one attribute at a time.\nexport const UpdateStudentBody = z.object({\n  firstName: z.string().trim().min(1),\n  lastName: z.string().trim().min(1),\n  email: z.string().email(),\n});\nexport type UpdateStudentBody = z.infer<typeof UpdateStudentBody>;\n"],"mappings":";;;AAIA,MAAa,gBAAgB,EAAE,KAAK,CAAC,WAAW,QAAQ,CAAC;AAGzD,MAAa,UAAU,qBAAqB,OAAO;CACjD,kBAAkB,EAAE,OAAO,CAAC,CAAC,IAAI;;CAEjC,aAAa,EAAE,OAAO,CAAC,CAAC,IAAI;;CAE5B,QAAQ;CACR,UAAU,EAAE,OAAO;CACnB,cAAc,EAAE,OAAO,CAAC,CAAC,SAAS;AACpC,CAAC;AAGD,MAAa,gBAAgB;AAG7B,MAAa,eAAe,UAAU,OAAO;AAG7C,MAAa,iBAAiB,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAKzD,MAAa,oBAAoB,EAAE,OAAO;CACxC,WAAW,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;CAClC,UAAU,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;CACjC,OAAO,EAAE,OAAO,CAAC,CAAC,MAAM;AAC1B,CAAC"}