@velora-cms/api-schemas 0.9.0

package/dist/template-api.schema.d.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+export declare const CreateTemplateRequestSchema: z.ZodObject<{
+    name: z.ZodString;
+    documentTypeId: z.ZodString;
+}, z.core.$strict>;
+export type CreateTemplateRequest = z.infer<typeof CreateTemplateRequestSchema>;
+export declare const CreateTemplateResponseSchema: z.ZodObject<{
+    template: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        documentTypeId: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strip>;
+export type CreateTemplateResponse = z.infer<typeof CreateTemplateResponseSchema>;
+export declare const TemplateListQuerySchema: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    documentTypeId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type TemplateListQuery = z.infer<typeof TemplateListQuerySchema>;
+export declare const TemplateListResponseSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        documentTypeId: z.ZodString;
+    }, z.core.$strict>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type TemplateListResponse = z.infer<typeof TemplateListResponseSchema>;
+export declare const SetDefaultTemplateRequestSchema: z.ZodObject<{
+    templateId: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type SetDefaultTemplateRequest = z.infer<typeof SetDefaultTemplateRequestSchema>;

package/dist/template-api.schema.js

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import { TemplateDefinitionSchema } from "./template.schema.js";
+// Same shape as TemplateDefinitionSchema minus `id` — the server mints that.
+export const CreateTemplateRequestSchema = z
+    .object({
+    name: z.string().min(1),
+    documentTypeId: z.string().uuid(),
+})
+    .strict();
+export const CreateTemplateResponseSchema = z.object({
+    template: TemplateDefinitionSchema,
+});
+// Per api-design.md, list endpoints are always cursor-paginated. The
+// optional documentTypeId filter is what the builder's template picker
+// uses to list "templates for this document type."
+export const TemplateListQuerySchema = z.object({
+    cursor: z.string().uuid().optional(),
+    limit: z.coerce.number().int().min(1).max(100).default(50),
+    documentTypeId: z.string().uuid().optional(),
+});
+export const TemplateListResponseSchema = z.object({
+    items: z.array(TemplateDefinitionSchema),
+    nextCursor: z.string().uuid().nullable(),
+});
+// Body for PATCH /api/document-types/:id/default-template.
+export const SetDefaultTemplateRequestSchema = z.object({
+    templateId: z.string().uuid().nullable(),
+});

package/dist/template.schema.d.ts

@@ -0,0 +1,7 @@
+import { z } from "zod";
+export declare const TemplateDefinitionSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    documentTypeId: z.ZodString;
+}, z.core.$strict>;
+export type TemplateDefinition = z.infer<typeof TemplateDefinitionSchema>;

package/dist/template.schema.js

@@ -0,0 +1,13 @@
+import { z } from "zod";
+// A named template record referencing a document type ('page' kind only,
+// enforced at the request-schema level in template-api.schema.ts and at
+// the write path in DatabaseAdapter, not here — this is the persisted
+// shape). Rendering HTML from a template is out of scope: this schema is
+// deliberately inert data, a future rendering engine's job to consume.
+export const TemplateDefinitionSchema = z
+    .object({
+    id: z.string().uuid(),
+    name: z.string().min(1),
+    documentTypeId: z.string().uuid(),
+})
+    .strict();

package/dist/theme-api.schema.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod";
+/** GET /api/themes — installed, enabled theme plugins' token overrides.
+ * tokens is the manifest's contributions.themeTokens passed through
+ * verbatim; its inner shape is validated at install time by the SDK's
+ * themeTokensSchema, so here it is an opaque record (color/radius). */
+export declare const ThemeListItemSchema: z.ZodObject<{
+    pluginId: z.ZodString;
+    name: z.ZodString;
+    author: z.ZodString;
+    tokens: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+export declare const ThemeListResponseSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        pluginId: z.ZodString;
+        name: z.ZodString;
+        author: z.ZodString;
+        tokens: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ThemeListItem = z.infer<typeof ThemeListItemSchema>;
+export type ThemeListResponse = z.infer<typeof ThemeListResponseSchema>;

package/dist/theme-api.schema.js

@@ -0,0 +1,14 @@
+import { z } from "zod";
+/** GET /api/themes — installed, enabled theme plugins' token overrides.
+ * tokens is the manifest's contributions.themeTokens passed through
+ * verbatim; its inner shape is validated at install time by the SDK's
+ * themeTokensSchema, so here it is an opaque record (color/radius). */
+export const ThemeListItemSchema = z.object({
+    pluginId: z.string(),
+    name: z.string(),
+    author: z.string(),
+    tokens: z.record(z.string(), z.unknown()),
+});
+export const ThemeListResponseSchema = z.object({
+    items: z.array(ThemeListItemSchema),
+});

package/dist/user-api.schema.d.ts

@@ -0,0 +1,79 @@
+import { z } from "zod";
+export declare const UserRoleSchema: z.ZodEnum<{
+    admin: "admin";
+    editor: "editor";
+}>;
+export type UserRole = z.infer<typeof UserRoleSchema>;
+export declare const UserSummarySchema: z.ZodObject<{
+    id: z.ZodString;
+    email: z.ZodString;
+    name: z.ZodNullable<z.ZodString>;
+    role: z.ZodEnum<{
+        admin: "admin";
+        editor: "editor";
+    }>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export type UserSummary = z.infer<typeof UserSummarySchema>;
+export declare const UserListQuerySchema: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export type UserListQuery = z.infer<typeof UserListQuerySchema>;
+export declare const UserListResponseSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        email: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+        role: z.ZodEnum<{
+            admin: "admin";
+            editor: "editor";
+        }>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type UserListResponse = z.infer<typeof UserListResponseSchema>;
+export declare const CreateUserRequestSchema: z.ZodObject<{
+    email: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    password: z.ZodString;
+    role: z.ZodEnum<{
+        admin: "admin";
+        editor: "editor";
+    }>;
+}, z.core.$strip>;
+export type CreateUserRequest = z.infer<typeof CreateUserRequestSchema>;
+export declare const CreateUserResponseSchema: z.ZodObject<{
+    user: z.ZodObject<{
+        id: z.ZodString;
+        email: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+        role: z.ZodEnum<{
+            admin: "admin";
+            editor: "editor";
+        }>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type CreateUserResponse = z.infer<typeof CreateUserResponseSchema>;
+export declare const UpdateUserRoleRequestSchema: z.ZodObject<{
+    role: z.ZodEnum<{
+        admin: "admin";
+        editor: "editor";
+    }>;
+}, z.core.$strip>;
+export type UpdateUserRoleRequest = z.infer<typeof UpdateUserRoleRequestSchema>;
+export declare const UpdateUserRoleResponseSchema: z.ZodObject<{
+    user: z.ZodObject<{
+        id: z.ZodString;
+        email: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+        role: z.ZodEnum<{
+            admin: "admin";
+            editor: "editor";
+        }>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type UpdateUserRoleResponse = z.infer<typeof UpdateUserRoleResponseSchema>;

package/dist/user-api.schema.js

@@ -0,0 +1,36 @@
+import { z } from "zod";
+// Wire format for roles — matches the Prisma enum values exactly
+// (lowercase on purpose) so no mapping layer exists anywhere.
+export const UserRoleSchema = z.enum(["admin", "editor"]);
+// What user management reads — never the passwordHash.
+export const UserSummarySchema = z.object({
+    id: z.string().uuid(),
+    email: z.string().email(),
+    name: z.string().nullable(),
+    role: UserRoleSchema,
+    createdAt: z.string().datetime(),
+});
+export const UserListQuerySchema = z.object({
+    cursor: z.string().uuid().optional(),
+    limit: z.coerce.number().int().min(1).max(100).default(50),
+});
+export const UserListResponseSchema = z.object({
+    items: z.array(UserSummarySchema),
+    // null = no more pages.
+    nextCursor: z.string().uuid().nullable(),
+});
+export const CreateUserRequestSchema = z.object({
+    email: z.string().email(),
+    name: z.string().min(1).optional(),
+    password: z.string().min(8),
+    role: UserRoleSchema,
+});
+export const CreateUserResponseSchema = z.object({
+    user: UserSummarySchema,
+});
+export const UpdateUserRoleRequestSchema = z.object({
+    role: UserRoleSchema,
+});
+export const UpdateUserRoleResponseSchema = z.object({
+    user: UserSummarySchema,
+});

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@velora-cms/api-schemas",
+  "version": "0.9.0",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/velora-cms/velora.git",
+    "directory": "packages/api-schemas"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "zod": "4.4.3"
+  },
+  "scripts": {
+    "build": "tsc -p .",
+    "test": "vitest run"
+  }
+}