@opensaas/stack-core 0.1.0

package/dist/config/types.d.ts

@@ -0,0 +1,413 @@
+import type { AccessControl, FieldAccess } from '../access/types.js';
+import type { z } from 'zod';
+/**
+ * Field configuration types
+ */
+export type FieldType = 'text' | 'integer' | 'checkbox' | 'timestamp' | 'password' | 'select' | 'relationship' | string;
+/**
+ * Field-level hooks for data transformation and side effects
+ * Allows field types to define custom behavior during operations
+ *
+ * @template TInput - Type of the input value (what goes into the database)
+ * @template TOutput - Type of the output value (what comes out of the database)
+ * @template TItem - Type of the parent item/record
+ */
+export type FieldHooks<TInput = any, TOutput = TInput, TItem = any> = {
+    /**
+     * Transform field value before database write
+     * Called during create/update operations after list-level resolveInput but before validation
+     * This is where you should transform input data (e.g., hash passwords, normalize values)
+     *
+     * @example
+     * ```typescript
+     * resolveInput: async ({ inputValue, operation }) => {
+     *   if (typeof inputValue === 'string' && !isHashedPassword(inputValue)) {
+     *     return await hashPassword(inputValue)
+     *   }
+     *   return inputValue
+     * }
+     * ```
+     */
+    resolveInput?: (args: {
+        operation: 'create' | 'update';
+        inputValue: TInput | undefined;
+        item?: TItem;
+        listKey: string;
+        fieldName: string;
+        context: import('../access/types.js').AccessContext;
+    }) => Promise<TInput | undefined> | TInput | undefined;
+    /**
+     * Perform side effects before database write
+     * Called during create/update/delete operations after validation and access control
+     * This should ONLY contain side effects (logging, notifications, etc.), not data transformation
+     *
+     * @example
+     * ```typescript
+     * beforeOperation: async ({ resolvedValue, operation, item }) => {
+     *   console.log(`About to ${operation} field with value:`, resolvedValue)
+     *   await sendAuditLog({ operation, item })
+     * }
+     * ```
+     */
+    beforeOperation?: (args: {
+        operation: 'create' | 'update' | 'delete';
+        resolvedValue: TInput | undefined;
+        item?: TItem;
+        listKey: string;
+        fieldName: string;
+        context: import('../access/types.js').AccessContext;
+    }) => Promise<void> | void;
+    /**
+     * Perform side effects after database operation
+     * Called after any database operation (create/update/delete/query)
+     * This should ONLY contain side effects (logging, cache invalidation, etc.), not data transformation
+     *
+     * @example
+     * ```typescript
+     * afterOperation: async ({ operation, value, item }) => {
+     *   await invalidateCache({ listKey, itemId: item.id })
+     *   await sendWebhook({ operation, item })
+     * }
+     * ```
+     */
+    afterOperation?: (args: {
+        operation: 'create' | 'update' | 'delete';
+        value: TInput | undefined;
+        item: TItem;
+        listKey: string;
+        fieldName: string;
+        context: import('../access/types.js').AccessContext;
+    } | {
+        operation: 'query';
+        value: TOutput | undefined;
+        item: TItem;
+        listKey: string;
+        fieldName: string;
+        context: import('../access/types.js').AccessContext;
+    }) => Promise<void> | void;
+    /**
+     * Transform field value after database read
+     * Called when returning results from query operations
+     * This is where you should transform output data (e.g., wrap passwords, format values)
+     *
+     * @example
+     * ```typescript
+     * resolveOutput: ({ value }) => {
+     *   if (typeof value === 'string' && value.length > 0) {
+     *     return new HashedPassword(value)
+     *   }
+     *   return value
+     * }
+     * ```
+     */
+    resolveOutput?: (args: {
+        operation: 'query';
+        value: TInput | undefined;
+        item: TItem;
+        listKey: string;
+        fieldName: string;
+        context: import('../access/types.js').AccessContext;
+    }) => TOutput | undefined;
+};
+/**
+ * Configuration for patching Prisma-generated types
+ * Allows fields to transform their types in query results
+ */
+export type TypePatchConfig = {
+    /**
+     * The TypeScript type to use in Prisma result types (e.g., Payload scalars)
+     * This is an import statement like: "import('@opensaas/stack-core').HashedPassword"
+     */
+    resultType: string;
+    /**
+     * Optional: Where to apply the patch
+     * - 'scalars-only': Only patch in Payload scalars (default, safest)
+     * - 'all': Patch everywhere the field appears (including inputs)
+     */
+    patchScope?: 'scalars-only' | 'all';
+};
+export type BaseFieldConfig<TInput = any, TOutput = TInput> = {
+    type: string;
+    access?: FieldAccess;
+    defaultValue?: unknown;
+    hooks?: FieldHooks<TInput, TOutput, any>;
+    /**
+     * Type patching configuration for Prisma-generated types
+     * When specified, the generator will patch Prisma's types to use
+     * the specified type in query results instead of the original type
+     */
+    typePatch?: TypePatchConfig;
+    ui?: {
+        /**
+         * Custom React component to render this field
+         * Overrides the default component for this field type
+         * Uses `any` to accept any React component type without overly complex generics
+         */
+        component?: any;
+        /**
+         * Custom field type name to use from the global registry
+         * e.g., "color" to use a globally registered ColorPickerField
+         */
+        fieldType?: string;
+        /**
+         * Transform field value before sending to client (browser)
+         * Useful for sensitive fields (e.g., passwords) or complex data structures
+         * that shouldn't be serialized in their raw form
+         *
+         * @example
+         * ```typescript
+         * // Password field: send only whether it's set, not the hash
+         * valueForClientSerialization: ({ value }) => ({ isSet: !!value })
+         * ```
+         */
+        valueForClientSerialization?: (args: {
+            value: unknown;
+        }) => unknown;
+        /**
+         * Additional UI-specific configuration
+         */
+        [key: string]: unknown;
+    };
+    /**
+     * Generate Zod schema for this field
+     * @param fieldName - The name of the field (for error messages)
+     * @param operation - Whether this is a create or update operation
+     */
+    getZodSchema?: (fieldName: string, operation: 'create' | 'update') => z.ZodTypeAny;
+    /**
+     * Get Prisma type and modifiers for schema generation
+     * @param fieldName - The name of the field (for generating modifiers)
+     * @returns Prisma type string and optional modifiers
+     */
+    getPrismaType?: (fieldName: string) => {
+        type: string;
+        modifiers?: string;
+    };
+    /**
+     * Get TypeScript type information for type generation
+     * @returns TypeScript type string and optionality
+     */
+    getTypeScriptType?: () => {
+        type: string;
+        optional: boolean;
+    };
+};
+export type TextField = BaseFieldConfig<string, string> & {
+    type: 'text';
+    validation?: {
+        isRequired?: boolean;
+        length?: {
+            min?: number;
+            max?: number;
+        };
+    };
+    isIndexed?: boolean | 'unique';
+    ui?: {
+        displayMode?: 'input' | 'textarea';
+    };
+};
+export type IntegerField = BaseFieldConfig<number, number> & {
+    type: 'integer';
+    validation?: {
+        isRequired?: boolean;
+        min?: number;
+        max?: number;
+    };
+};
+export type CheckboxField = BaseFieldConfig<boolean, boolean> & {
+    type: 'checkbox';
+};
+export type TimestampField = BaseFieldConfig<Date, Date> & {
+    type: 'timestamp';
+    defaultValue?: {
+        kind: 'now';
+    } | Date;
+};
+export type PasswordField = BaseFieldConfig<string, import('../utils/password.js').HashedPassword> & {
+    type: 'password';
+    validation?: {
+        isRequired?: boolean;
+    };
+};
+export type SelectField = BaseFieldConfig<string, string> & {
+    type: 'select';
+    options: Array<{
+        label: string;
+        value: string;
+    }>;
+    validation?: {
+        isRequired?: boolean;
+    };
+    ui?: {
+        displayMode?: 'select' | 'segmented-control' | 'radio';
+    };
+};
+export type RelationshipField = BaseFieldConfig<string | string[], string | string[]> & {
+    type: 'relationship';
+    ref: string;
+    many?: boolean;
+    ui?: {
+        displayMode?: 'select' | 'cards';
+    };
+};
+export type FieldConfig = TextField | IntegerField | CheckboxField | TimestampField | PasswordField | SelectField | RelationshipField | BaseFieldConfig;
+/**
+ * List configuration types
+ */
+/**
+ * Utility type to inject item type into a single field config
+ * Extracts TInput and TOutput from BaseFieldConfig<TInput, TOutput> and reconstructs with new hooks type
+ */
+type WithItemType<TField extends FieldConfig, TItem> = TField extends BaseFieldConfig<infer TInput, infer TOutput> ? Omit<TField, 'hooks'> & {
+    hooks?: FieldHooks<TInput, TOutput, TItem>;
+} : TField;
+/**
+ * Utility type to transform all fields in a record to inject item type
+ * Maps over each field and applies WithItemType transformation
+ */
+export type FieldsWithItemType<TFields extends Record<string, FieldConfig>, TItem = any> = {
+    [K in keyof TFields]: WithItemType<TFields[K], TItem>;
+};
+export type OperationAccess<T = any> = {
+    query?: AccessControl<T>;
+    create?: AccessControl<T>;
+    update?: AccessControl<T>;
+    delete?: AccessControl<T>;
+};
+export type HookArgs<T = Record<string, unknown>> = {
+    operation: 'create' | 'update' | 'delete';
+    resolvedData?: Partial<T>;
+    item?: T;
+    context: import('../access/types.js').AccessContext;
+};
+export type Hooks<T = Record<string, unknown>> = {
+    resolveInput?: (args: HookArgs<T> & {
+        operation: 'create' | 'update';
+    }) => Promise<Partial<T>>;
+    validateInput?: (args: HookArgs<T> & {
+        operation: 'create' | 'update';
+        addValidationError: (msg: string) => void;
+    }) => Promise<void>;
+    beforeOperation?: (args: HookArgs<T>) => Promise<void>;
+    afterOperation?: (args: HookArgs<T>) => Promise<void>;
+};
+export type ListConfig<T = any> = {
+    fields: FieldsWithItemType<Record<string, FieldConfig>, T>;
+    access?: {
+        operation?: OperationAccess<T>;
+    };
+    hooks?: Hooks<T>;
+};
+/**
+ * Database configuration
+ */
+export type DatabaseConfig = {
+    provider: 'postgresql' | 'mysql' | 'sqlite';
+    url: string;
+    /**
+     * Optional factory function to create a custom Prisma client instance
+     * Receives the PrismaClient class and returns a configured instance
+     *
+     * @example
+     * ```typescript
+     * import { PrismaNeon } from '@prisma/adapter-neon'
+     * import { neonConfig } from '@neondatabase/serverless'
+     * import ws from 'ws'
+     *
+     * prismaClientConstructor: (PrismaClient) => {
+     *   neonConfig.webSocketConstructor = ws
+     *   const adapter = new PrismaNeon({
+     *     connectionString: process.env.DATABASE_URL
+     *   })
+     *   return new PrismaClient({ adapter })
+     * }
+     * ```
+     */
+    prismaClientConstructor?: (PrismaClientClass: any) => any;
+};
+/**
+ * Session configuration
+ */
+export type SessionConfig = {
+    getSession: () => Promise<any>;
+};
+/**
+ * Theme preset options
+ */
+export type ThemePreset = 'modern' | 'classic' | 'neon';
+/**
+ * Custom theme colors (HSL values without hsl() wrapper)
+ * Format: "220 20% 97%" (hue saturation lightness)
+ */
+export type ThemeColors = {
+    background?: string;
+    foreground?: string;
+    card?: string;
+    cardForeground?: string;
+    popover?: string;
+    popoverForeground?: string;
+    primary?: string;
+    primaryForeground?: string;
+    secondary?: string;
+    secondaryForeground?: string;
+    muted?: string;
+    mutedForeground?: string;
+    accent?: string;
+    accentForeground?: string;
+    destructive?: string;
+    destructiveForeground?: string;
+    border?: string;
+    input?: string;
+    ring?: string;
+    gradientFrom?: string;
+    gradientTo?: string;
+};
+/**
+ * Theme configuration
+ */
+export type ThemeConfig = {
+    /**
+     * Preset theme to use
+     * @default "modern"
+     */
+    preset?: ThemePreset;
+    /**
+     * Custom color overrides for light mode
+     */
+    colors?: ThemeColors;
+    /**
+     * Custom color overrides for dark mode
+     */
+    darkColors?: ThemeColors;
+    /**
+     * Border radius in rem
+     * @default 0.75
+     */
+    radius?: number;
+};
+/**
+ * UI configuration
+ */
+export type UIConfig = {
+    basePath?: string;
+    /**
+     * Theme configuration for the admin UI
+     */
+    theme?: ThemeConfig;
+};
+/**
+ * Main configuration type
+ */
+export type OpenSaasConfig = {
+    db: DatabaseConfig;
+    lists: Record<string, ListConfig>;
+    session?: SessionConfig;
+    ui?: UIConfig;
+    /**
+     * Path where OpenSaas generates files (context, types, patched Prisma client)
+     * @default ".opensaas"
+     */
+    opensaasPath?: string;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"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"}

package/dist/config/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":""}

package/dist/context/index.d.ts

@@ -0,0 +1,31 @@
+import type { OpenSaasConfig } from '../config/types.js';
+import type { Session, AccessControlledDB } from '../access/index.js';
+import type { PrismaClientLike } from '../access/types.js';
+export type ServerActionProps = {
+    listKey: string;
+    action: 'create';
+    data: Record<string, unknown>;
+} | {
+    listKey: string;
+    action: 'update';
+    id: string;
+    data: Record<string, unknown>;
+} | {
+    listKey: string;
+    action: 'delete';
+    id: string;
+};
+/**
+ * Create an access-controlled context
+ *
+ * @param config - OpenSaas configuration
+ * @param prisma - Your Prisma client instance (pass as generic for type safety)
+ * @param session - Current session object (or null if not authenticated)
+ */
+export declare function getContext<TConfig extends OpenSaasConfig, TPrisma extends PrismaClientLike = PrismaClientLike>(config: TConfig, prisma: TPrisma, session: Session): {
+    db: AccessControlledDB<TPrisma>;
+    session: Session;
+    prisma: TPrisma;
+    serverAction: (props: ServerActionProps) => Promise<unknown>;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,oBAAoB,CAAA;AACpE,OAAO,KAAK,EAAE,OAAO,EAAiB,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAkBpF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAmJ1D,MAAM,MAAM,iBAAiB,GACzB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACpE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAChF;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAA;AACrD;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,OAAO,SAAS,cAAc,EAC9B,OAAO,SAAS,gBAAgB,GAAG,gBAAgB,EAEnD,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,OAAO,GACf;IACD,EAAE,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAA;IAC/B,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;IACf,YAAY,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC7D,CAyDA"}