@kanian77/pastry-shared 0.0.1

package/dist/zod-schemas/baseZodUserRoleSchema.d.ts

@@ -0,0 +1,17 @@
+import z from 'zod';
+import { UserRoleEnum } from '../types';
+export declare const baseZodUserRoleSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    createdAt: z.ZodDate;
+    updatedAt: z.ZodOptional<z.ZodDate>;
+    createdBy: z.ZodOptional<z.ZodUUID>;
+    updatedBy: z.ZodOptional<z.ZodUUID>;
+    deleted: z.ZodDefault<z.ZodBoolean>;
+    deletedAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+    name: z.ZodString;
+    slug: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    type: z.ZodEnum<typeof UserRoleEnum>;
+}, z.core.$strip>;
+export type UserRoleInterface = z.infer<typeof baseZodUserRoleSchema>;
+//# sourceMappingURL=baseZodUserRoleSchema.d.ts.map

package/dist/zod-schemas/baseZodUserRoleSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseZodUserRoleSchema.d.ts","sourceRoot":"","sources":["../../src/zod-schemas/baseZodUserRoleSchema.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,eAAO,MAAM,qBAAqB;;;;;;;;;;;;iBAKhC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/zod-schemas/baseZodUserRoleSchema.js

@@ -0,0 +1,10 @@
+import z from 'zod';
+import { baseZodEntitySchema } from './baseZodEntitySchema';
+import { UserRoleEnum } from '../types';
+export const baseZodUserRoleSchema = baseZodEntitySchema.extend({
+    name: z.string().min(1).max(255),
+    slug: z.string().max(255).optional(),
+    description: z.string().optional(),
+    type: z.enum(UserRoleEnum),
+});
+//# sourceMappingURL=baseZodUserRoleSchema.js.map

package/dist/zod-schemas/baseZodUserRoleSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseZodUserRoleSchema.js","sourceRoot":"","sources":["../../src/zod-schemas/baseZodUserRoleSchema.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,CAAC,MAAM,qBAAqB,GAAG,mBAAmB,CAAC,MAAM,CAAC;IAC9D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACpC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC;CAC3B,CAAC,CAAC"}

package/dist/zod-schemas/baseZodUserSchema.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+import { UserTypeEnum } from '../types';
+export declare const baseZodUserSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    createdAt: z.ZodDate;
+    updatedAt: z.ZodOptional<z.ZodDate>;
+    createdBy: z.ZodOptional<z.ZodUUID>;
+    updatedBy: z.ZodOptional<z.ZodUUID>;
+    deleted: z.ZodDefault<z.ZodBoolean>;
+    deletedAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+    email: z.ZodOptional<z.ZodEmail>;
+    password: z.ZodOptional<z.ZodString>;
+    firstName: z.ZodOptional<z.ZodString>;
+    lastName: z.ZodOptional<z.ZodString>;
+    roleId: z.ZodUUID;
+    phoneNumber: z.ZodOptional<z.ZodObject<{
+        countryCode: z.ZodString;
+        number: z.ZodString;
+        type: z.ZodEnum<typeof import("../types/PhoneNumberTypes").PhoneNumberTypes>;
+    }, z.core.$strip>>;
+    userType: z.ZodEnum<typeof UserTypeEnum>;
+}, z.core.$strip>;
+export type UserInterface = z.infer<typeof baseZodUserSchema>;
+//# sourceMappingURL=baseZodUserSchema.d.ts.map

package/dist/zod-schemas/baseZodUserSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseZodUserSchema.d.ts","sourceRoot":"","sources":["../../src/zod-schemas/baseZodUserSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGxC,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;iBAQ5B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/zod-schemas/baseZodUserSchema.js

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+import { baseZodEntitySchema } from './baseZodEntitySchema';
+import { UserTypeEnum } from '../types';
+import { phoneNumberSchema } from './phoneNumberSchema';
+export const baseZodUserSchema = baseZodEntitySchema.extend({
+    email: z.email().optional(),
+    password: z.string().optional(),
+    firstName: z.string().max(255).optional(),
+    lastName: z.string().max(255).optional(),
+    roleId: z.uuid(),
+    phoneNumber: phoneNumberSchema.optional(),
+    userType: z.enum(UserTypeEnum),
+});
+//# sourceMappingURL=baseZodUserSchema.js.map

package/dist/zod-schemas/baseZodUserSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseZodUserSchema.js","sourceRoot":"","sources":["../../src/zod-schemas/baseZodUserSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,MAAM,CAAC;IAC1D,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACzC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACxC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE;IAChB,WAAW,EAAE,iBAAiB,CAAC,QAAQ,EAAE;IACzC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC;CAC/B,CAAC,CAAC"}

package/dist/zod-schemas/index.d.ts

@@ -0,0 +1,9 @@
+export * from './baseZodSchemaSchema';
+export * from './baseZodEntitySchema';
+export * from './baseZodContentSchema';
+export * from './baseZodContentRelationSchema';
+export * from './baseZodUserRoleSchema';
+export * from './baseZodUserSchema';
+export * from './baseZodPermissionSchema';
+export * from './phoneNumberSchema';
+//# sourceMappingURL=index.d.ts.map

package/dist/zod-schemas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/zod-schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC"}

package/dist/zod-schemas/index.js

@@ -0,0 +1,9 @@
+export * from './baseZodSchemaSchema';
+export * from './baseZodEntitySchema';
+export * from './baseZodContentSchema';
+export * from './baseZodContentRelationSchema';
+export * from './baseZodUserRoleSchema';
+export * from './baseZodUserSchema';
+export * from './baseZodPermissionSchema';
+export * from './phoneNumberSchema';
+//# sourceMappingURL=index.js.map

package/dist/zod-schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/zod-schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC"}

package/dist/zod-schemas/phoneNumberSchema.d.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import { PhoneNumberTypes } from '../types/PhoneNumberTypes';
+export declare const phoneNumberSchema: z.ZodObject<{
+    countryCode: z.ZodString;
+    number: z.ZodString;
+    type: z.ZodEnum<typeof PhoneNumberTypes>;
+}, z.core.$strip>;
+export type PhoneNumberInterface = z.infer<typeof phoneNumberSchema>;
+//# sourceMappingURL=phoneNumberSchema.d.ts.map

package/dist/zod-schemas/phoneNumberSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phoneNumberSchema.d.ts","sourceRoot":"","sources":["../../src/zod-schemas/phoneNumberSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D,eAAO,MAAM,iBAAiB;;;;iBAI5B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/zod-schemas/phoneNumberSchema.js

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+import { PhoneNumberTypes } from '../types/PhoneNumberTypes';
+export const phoneNumberSchema = z.object({
+    countryCode: z.string(),
+    number: z.string(),
+    type: z.enum(PhoneNumberTypes),
+});
+//# sourceMappingURL=phoneNumberSchema.js.map

package/dist/zod-schemas/phoneNumberSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phoneNumberSchema.js","sourceRoot":"","sources":["../../src/zod-schemas/phoneNumberSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC;CAC/B,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@kanian77/pastry-shared",
+  "version": "0.0.1",
+  "description": "shared constructs for @kanian77/pastry",
+  "author": "Patrick Assoa Adou <kanian77@gmail.com>",
+  "keywords": [
+    "utilities",
+    "types",
+    "shared"
+  ],
+  "license": "MIT",
+  "packageManager": "bun@1.2.4",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./dist/*": {
+      "import": "./dist/*.js",
+      "require": "./dist/*.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc --build --verbose",
+    "dev": "tsc --build --verbose --watch",
+    "clean": "rm -rf dist && rm -rf tsconfig.tsbuildinfo",
+    "prepare": "bun run clean && bun run build",
+    "release": "bun run prepare && npm publish --userconfig .npmrc --access public"
+  },
+  "devDependencies": {
+    "typescript": "~5.7.2",
+    "zod": "^4.1.12"
+  },
+  "dependencies": {
+    "@types/bun": "^1.2.4",
+    "jose": "^6.1.3"
+  },
+  "peerDependencies": {
+    "zod": "^4.1.12"
+  }
+}

package/src/functions/getEnvFile.ts

@@ -0,0 +1,19 @@
+import { EnvFileNames } from '../types/EnvFileNames';
+import { Envs } from '../types/Envs';
+
+export const getEnvFile = () => {
+  switch (process.env.ENV) {
+    case Envs.DEVELOPMENT:
+      return EnvFileNames.DEVELOPMENT;
+    case Envs.TESTING:
+      return EnvFileNames.TESTING;
+    case Envs.PRODUCTION:
+      return EnvFileNames.PRODUCTION;
+    case Envs.DEBUGGING:
+      return EnvFileNames.DEBUGGING;
+    case Envs.STAGING:
+      return EnvFileNames.STAGING;
+    default:
+      return undefined;
+  }
+};

package/src/functions/index.ts

@@ -0,0 +1,2 @@
+export * from './getEnvFile';
+export * from './isNotNullNorUndefined';

package/src/functions/isNotNullNorUndefined.ts

@@ -0,0 +1,5 @@
+export function isNotNullNorUndefined<T>(
+  value: T | null | undefined
+): value is T {
+  return value !== null && value !== undefined;
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export * from './functions';
+export * from './types';
+export * from './zod-schemas';

package/src/types/ContentStatusEnum.ts

@@ -0,0 +1,7 @@
+export enum ContentStatusEnum {
+  DRAFT = 'draft',
+  PUBLISHED = 'published',
+  ARCHIVED = 'archived',
+  REVIEW = 'review',
+  DELETED = 'deleted',
+}

package/src/types/EnvFileNames.ts

@@ -0,0 +1,7 @@
+export enum EnvFileNames {
+  PRODUCTION = '.env.prod',
+  DEVELOPMENT = '.env.development',
+  TESTING = '.env.testing',
+  DEBUGGING = '.env.debugging',
+  STAGING = '.env.staging',
+}

package/src/types/Envs.ts

@@ -0,0 +1,7 @@
+export enum Envs {
+  PRODUCTION = 'prod',
+  STAGING = 'staging',
+  DEVELOPMENT = 'dev',
+  TESTING = 'test',
+  DEBUGGING = 'debug',
+}

package/src/types/FindAllBySchemaIdOptions.ts

@@ -0,0 +1,10 @@
+import { PaginationParams } from './PaginationParams';
+import { SortConfig } from './SortConfig';
+import { FindAllOptions } from './FindAllOptions';
+
+/**
+ * Repository options for findAll
+ */
+export interface FindAllBySchemaIdOptions extends FindAllOptions {
+  schemaId: string;
+}

package/src/types/FindAllBySchemaIdsOptions.ts

@@ -0,0 +1,10 @@
+import { PaginationParams } from './PaginationParams';
+import { SortConfig } from './SortConfig';
+import { FindAllOptions } from './FindAllOptions';
+
+/**
+ * Repository options for findAll
+ */
+export interface FindAllBySchemaIdsOptions extends FindAllOptions {
+  schemaIds: string[];
+}

package/src/types/FindAllOptions.ts

@@ -0,0 +1,11 @@
+import { PaginationParams } from "./PaginationParams";
+import { SortConfig } from "./SortConfig";
+
+/**
+ * Repository options for findAll
+ */
+export interface FindAllOptions {
+  withDeleted?: boolean;
+  pagination?: PaginationParams;
+  sort?: SortConfig;
+}

package/src/types/FindByDerivedSchemaFromSlugOptions.ts

@@ -0,0 +1,10 @@
+import { PaginationParams } from './PaginationParams';
+import { SortConfig } from './SortConfig';
+import { FindAllOptions } from './FindAllOptions';
+
+/**
+ * Repository options for findByDerivedSchemaFromSlug
+ */
+export interface FindByDerivedSchemaFromSlugOptions extends FindAllOptions {
+  slug: string;
+}

package/src/types/PAGINATION_DEFAULTS.ts

@@ -0,0 +1,8 @@
+/**
+ * Configuration constants for pagination
+ */
+export const PAGINATION_DEFAULTS = {
+  PAGE: 1,
+  LIMIT: 10,
+  MAX_LIMIT: 100, // Hard cap for safety
+};

package/src/types/PaginatedResult.ts

@@ -0,0 +1,9 @@
+import { PaginationMeta } from "./PaginationMeta";
+
+/**
+ * Standardized paginated response wrapper
+ */
+export interface PaginatedResult<T> {
+  data: T[];
+  meta: PaginationMeta;
+}

package/src/types/PaginationMeta.ts

@@ -0,0 +1,11 @@
+/**
+ * Metadata structure for paginated responses
+ */
+export interface PaginationMeta {
+  page: number;
+  limit: number;
+  total: number;
+  totalPages: number;
+  hasNextPage: boolean;
+  hasPrevPage: boolean;
+}

package/src/types/PaginationParams.ts

@@ -0,0 +1,7 @@
+/**
+ * Input parameters for list queries
+ */
+export interface PaginationParams {
+  page?: number;
+  limit?: number;
+}

package/src/types/PermissionsEnum.ts

@@ -0,0 +1,10 @@
+export enum PermissionsEnum {
+    CONTENT_CREATE = 'CONTENT_CREATE',
+    CONTENT_READ = 'CONTENT_READ',
+    CONTENT_UPDATE = 'CONTENT_UPDATE',
+    CONTENT_DELETE = 'CONTENT_DELETE',
+    SCHEMA_CREATE = 'SCHEMA_CREATE',
+    SCHEMA_READ = 'SCHEMA_READ',
+    SCHEMA_UPDATE = 'SCHEMA_UPDATE',
+    SCHEMA_DELETE = 'SCHEMA_DELETE',
+}

package/src/types/PhoneNumberTypes.ts

@@ -0,0 +1,8 @@
+// an enum called that specifies kinds of phone numbers (cellphone, home, work)
+export enum PhoneNumberTypes {
+  HOME = 'home',
+  MOBILE = 'mobile',
+  WORK = 'work',
+  PAGER = 'pager',
+  OTHER = 'other',
+}

package/src/types/RelationTypeEnum.ts

@@ -0,0 +1,4 @@
+export enum RelationTypeEnum {
+    ONE = 'one',
+    MANY = 'many'
+}

package/src/types/SortConfig.ts

@@ -0,0 +1,7 @@
+/**
+ * Sorting configuration
+ */
+export interface SortConfig {
+  field: string;
+  order: 'asc' | 'desc';
+}

package/src/types/TokenPayloadInterface.ts

@@ -0,0 +1,12 @@
+import { UserRoleInterface } from '../zod-schemas';
+import { PhoneNumberInterface } from '../zod-schemas/phoneNumberSchema';
+export interface TokenPayloadInterface {
+  userId: string;
+  firstName: string;
+  lastName: string;
+  email?: string;
+  role: Pick<UserRoleInterface, 'id' | 'slug' | 'name' | 'description'>;
+  phoneNumber?: PhoneNumberInterface;
+  exp: number;
+  iat: number;
+}

package/src/types/UserRoleEnum.ts

@@ -0,0 +1,7 @@
+export enum UserRoleEnum {
+  ADMIN = 'admin',
+  EDITOR = 'editor',
+  AUTHOR = 'author',
+  AUTHENTICATED = 'authenticated',
+  GUEST = 'guest',
+}

package/src/types/UserTypeEnum.ts

@@ -0,0 +1,4 @@
+export enum UserTypeEnum {
+    ADMIN = 'ADMIN',
+    USER = 'USER',
+}

package/src/types/index.ts

@@ -0,0 +1,17 @@
+export * from './EnvFileNames';
+export * from './Envs';
+export * from './ContentStatusEnum';
+export * from './RelationTypeEnum';
+export * from './UserRoleEnum';
+export * from './PermissionsEnum';
+export * from './TokenPayloadInterface';
+export * from './UserTypeEnum';
+export * from './PAGINATION_DEFAULTS';
+export * from './PaginationParams';
+export * from './PaginatedResult';
+export * from './PaginationMeta';
+export * from './FindAllOptions';
+export * from './SortConfig';
+export * from './FindAllBySchemaIdOptions';
+export * from './FindByDerivedSchemaFromSlugOptions';
+export * from './FindAllBySchemaIdsOptions';

package/src/zod-schemas/baseZodContentRelationSchema.ts

@@ -0,0 +1,15 @@
+import { z } from "zod";
+import { baseZodEntitySchema } from "./baseZodEntitySchema";
+
+export const relationTypeZodEnum = z.enum([
+    'one',
+    'many'
+])
+export const baseZodContentRelationSchema = baseZodEntitySchema.extend({
+    sourceContentId: z.uuid(),
+    targetContentId: z.uuid(),
+    relationType: relationTypeZodEnum.default('one'),
+    sourceFieldSlug: z.string().optional(),
+})
+
+export type ContentRelationInterface = z.infer<typeof baseZodContentRelationSchema>

package/src/zod-schemas/baseZodContentSchema.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import { baseZodEntitySchema } from './baseZodEntitySchema';
+
+// Enum for content status
+export const ContentStatusZodEnum = z.enum([
+  'draft',
+  'published',
+  'archived',
+  'review',
+  'deleted',
+]);
+
+export const baseZodContentSchema = baseZodEntitySchema.extend({
+  name: z.string().min(1).max(255),
+  schemaId: z.uuid(),
+  definition: z.any(), // Could be refined if you have a known structure
+  indexes: z.any().optional(),
+  status: ContentStatusZodEnum.default('draft'),
+  slug: z.string().max(255).optional(),
+  metadata: z.any().optional(),
+  userId: z.uuid(),
+});
+
+
+export type ContentInterface = z.infer<typeof baseZodContentSchema>;

package/src/zod-schemas/baseZodEntitySchema.ts

@@ -0,0 +1,13 @@
+import z from 'zod';
+
+export const baseZodEntitySchema = z.object({
+  id: z.uuid(),
+  createdAt: z.date(),
+  updatedAt: z.date().optional(),
+  createdBy: z.uuid().optional(),
+  updatedBy: z.uuid().optional(),
+  deleted: z.boolean().default(false),
+  deletedAt: z.date().nullable().optional(),
+});
+
+export type BaseEntityInterface = z.infer<typeof baseZodEntitySchema>;

package/src/zod-schemas/baseZodPermissionSchema.ts

@@ -0,0 +1,8 @@
+import z from 'zod';
+import { PermissionsEnum } from '../types';
+import { baseZodEntitySchema } from './baseZodEntitySchema';
+
+export const baseZodPermissionSchema = baseZodEntitySchema.extend({
+  action: z.enum(PermissionsEnum),
+  roleId: z.uuid(),
+});

package/src/zod-schemas/baseZodSchemaSchema.ts

@@ -0,0 +1,142 @@
+import { z } from 'zod';
+import { baseZodEntitySchema } from './baseZodEntitySchema';
+import { RelationTypeEnum } from '../types';
+
+// Allowed field types
+export const FieldTypeEnum = z.enum([
+  'text',
+  'richText',
+  'number',
+  'boolean',
+  'dateTime',
+  'json',
+  'relation',
+  'media',
+  'select',
+]);
+
+// Base properties shared by all fields
+export const BaseFieldSchema = z.object({
+  slug: z
+    .string()
+    .min(3)
+    .regex(
+      /^[a-zA-Z0-9_]+$/,
+      'API slugs can only contain letters, numbers, and underscores'
+    ),
+  label: z.string().min(1),
+  description: z.string().optional(),
+  required: z.boolean().default(false),
+  readOnly: z.boolean().default(false),
+  definition: z.object().optional(),
+});
+
+// Schema for a simple text field
+const TextFieldSchema = BaseFieldSchema.extend({
+  type: z.literal(FieldTypeEnum.enum.text),
+  minLength: z.number().int().min(0).optional(),
+  maxLength: z.number().int().min(1).optional(),
+  /** * A hint for the admin UI on how to render this field.
+   */
+  format: z
+    .enum(['singleLine', 'multiLine', 'email', 'url', 'slug'])
+    .default('singleLine'),
+  defaultValue: z.string().optional(),
+});
+
+// Schema for a rich text (Markdown/WYSIWYG) field
+const RichTextFieldSchema = BaseFieldSchema.extend({
+  type: z.literal(FieldTypeEnum.enum.richText),
+  editorType: z.enum(['markdown', 'wysiwyg']).default('markdown'),
+  defaultValue: z.string().optional(),
+});
+
+// Schema for a number field
+const NumberFieldSchema = BaseFieldSchema.extend({
+  type: z.literal(FieldTypeEnum.enum.number),
+  format: z.enum(['integer', 'decimal']).default('decimal'),
+  min: z.number().optional(),
+  max: z.number().optional(),
+  defaultValue: z.number().optional(),
+});
+
+// Schema for a boolean (toggle/checkbox) field
+const BooleanFieldSchema = BaseFieldSchema.extend({
+  type: z.literal(FieldTypeEnum.enum.boolean),
+  display: z.enum(['toggle', 'checkbox']).default('toggle'),
+  defaultValue: z.boolean().optional(),
+});
+
+// Schema for a date/time field
+const DateTimeFieldSchema = BaseFieldSchema.extend({
+  type: z.literal(FieldTypeEnum.enum.dateTime),
+  format: z.enum(['date', 'dateTime', 'time']).default('dateTime'),
+  defaultValue: z.date().or(z.string().datetime()).optional(),
+});
+
+// Schema for a "select" (enum) field
+const SelectOptionSchema = z.object({
+  label: z.string(),
+  value: z.string(),
+});
+
+const SelectFieldSchema = BaseFieldSchema.extend({
+  type: z.literal(FieldTypeEnum.enum.select),
+  options: z.array(SelectOptionSchema).min(1, 'Must have at least one option'),
+  allowMultiple: z.boolean().default(false),
+  defaultValue: z.string().or(z.array(z.string())).optional(),
+});
+
+// Schema for a relation (e.g., link to a 'User' or 'Category')
+const RelationFieldSchema = BaseFieldSchema.extend({
+  type: z.literal(FieldTypeEnum.enum.relation),
+  /**
+   * The apiId of the collection this field relates to.
+   */
+  targetCollectionId: z.string(),
+  relationType: z.enum(RelationTypeEnum),
+  display: z.enum(['select', 'autocomplete']).default('select'),
+});
+
+// Schema for a file/media upload field
+const MediaFieldSchema = BaseFieldSchema.extend({
+  type: z.literal(FieldTypeEnum.enum.media),
+  allowMultiple: z.boolean().default(false),
+  allowedMimeTypes: z.array(z.string()).optional(), // e.g., ['image/jpeg', 'application/pdf']
+  maxSizeInBytes: z.number().int().min(1).optional(),
+});
+
+// Schema for a raw JSON editor field
+const JsonFieldSchema = BaseFieldSchema.extend({
+  type: z.literal(FieldTypeEnum.enum.json),
+  defaultValue: z.record(z.string(), z.any()).optional(),
+});
+
+export const FieldSchema = z.discriminatedUnion('type', [
+  TextFieldSchema,
+  RichTextFieldSchema,
+  NumberFieldSchema,
+  BooleanFieldSchema,
+  DateTimeFieldSchema,
+  SelectFieldSchema,
+  RelationFieldSchema,
+  MediaFieldSchema,
+  JsonFieldSchema,
+]);
+
+export type FieldDefinition = z.infer<typeof FieldSchema>;
+
+// Base schema definition
+export const baseZodSchemaSchema = baseZodEntitySchema.extend({
+  name: z.string().min(1),
+  slug: z.string().regex(/^[a-z0-9_\-]+$/), // unique identifier
+  description: z.string().optional(),
+  fields: z.array(FieldSchema).min(1),
+  version: z.number().default(1),
+  userId: z.uuid(),
+  parentSchemaId: z.uuid().optional(),
+});
+
+export type FieldType = z.infer<typeof FieldTypeEnum>;
+export type Field = z.infer<typeof FieldSchema>;
+export type SchemaInterface = z.infer<typeof baseZodSchemaSchema>;

package/src/zod-schemas/baseZodUserRoleSchema.ts

@@ -0,0 +1,12 @@
+import z from 'zod';
+import { baseZodEntitySchema } from './baseZodEntitySchema';
+import { UserRoleEnum } from '../types';
+
+export const baseZodUserRoleSchema = baseZodEntitySchema.extend({
+  name: z.string().min(1).max(255),
+  slug: z.string().max(255).optional(),
+  description: z.string().optional(),
+  type: z.enum(UserRoleEnum),
+});
+
+export type UserRoleInterface = z.infer<typeof baseZodUserRoleSchema>;