@c15t/backend 0.0.1-rc.10

package/dist/db/adapters/types.d.ts

@@ -0,0 +1,154 @@
+import type { C15TOptions } from '../../types';
+import type { EntityInput, EntityName } from '../core/types';
+import type { C15TDBSchema } from '../schema/definition';
+import type { KyselyAdapterConfig } from './kysely-adapter';
+/**
+ * Type representing the fields of a database table for a specific entity
+ */
+export type TableFields<EntityType extends EntityName> = C15TDBSchema[EntityType]['fields'];
+/**
+ * Type representing the possible value types that can be used in query conditions
+ */
+export type Value = string | number | boolean | string[] | number[] | Date | null;
+/**
+ * Type representing the comparison operators available for query conditions
+ */
+export type ComparisonOperator = 'eq' | 'ne' | 'lt' | 'lte' | 'gt' | 'gte' | 'in' | 'contains' | 'starts_with' | 'ends_with' | 'ilike';
+/**
+ * Type representing the logical connectors for combining query conditions
+ */
+export type LogicalConnector = 'AND' | 'OR';
+/**
+ * Type representing a single query condition
+ */
+export type WhereCondition<EntityType extends EntityName> = {
+    /** The comparison operator to use (defaults to 'eq') */
+    operator?: ComparisonOperator;
+    /** The value to compare against */
+    value: Value;
+    /** The field to apply the condition to */
+    field: keyof TableFields<EntityType> | 'id';
+    /** The logical connector to use with previous conditions (defaults to 'AND') */
+    connector?: LogicalConnector;
+};
+/**
+ * Type representing a complete where clause for database queries
+ */
+export type Where<EntityType extends EntityName> = WhereCondition<EntityType>[];
+/**
+ * Type representing sorting options for queries
+ */
+export type SortOptions<EntityType extends EntityName> = {
+    /** The field to sort by */
+    field: keyof TableFields<EntityType> | 'id';
+    /** The sort direction */
+    direction: 'asc' | 'desc';
+};
+/**
+ * Type representing the result of a schema creation operation
+ */
+export type AdapterSchemaCreation = {
+    /** The code to be inserted into the file */
+    code: string;
+    /** The path to the file */
+    path: string;
+    /** Whether to append to existing file */
+    append?: boolean;
+    /** Whether to overwrite existing file */
+    overwrite?: boolean;
+};
+/**
+ * Interface defining the contract for database adapters
+ */
+export interface Adapter {
+    /** Unique identifier for the adapter */
+    id: string;
+    /** Creates a new record in the database */
+    create: <Model extends EntityName, Data extends Record<string, unknown>, Result extends TableFields<Model>>(data: {
+        model: Model;
+        data: Data;
+        select?: Array<keyof Result>;
+    }) => Promise<Result>;
+    /** Finds a single record matching the where conditions */
+    findOne: <Model extends EntityName, Result extends TableFields<Model>>(data: {
+        model: Model;
+        where: Where<Model>;
+        select?: Array<keyof Result>;
+        sortBy?: SortOptions<Model>;
+    }) => Promise<Result | null>;
+    /** Finds multiple records matching the where conditions */
+    findMany: <Model extends EntityName>(data: {
+        model: Model;
+        where?: Where<Model>;
+        limit?: number;
+        sortBy?: SortOptions<Model>;
+        offset?: number;
+    }) => Promise<TableFields<Model>[]>;
+    /** Counts records matching the where conditions */
+    count: <Model extends EntityName>(data: {
+        model: Model;
+        where?: Where<Model>;
+    }) => Promise<number>;
+    /** Updates a single record matching the where conditions */
+    update: <Model extends EntityName, Result extends TableFields<Model>>(data: {
+        model: Model;
+        where: Where<Model>;
+        update: EntityInput<Model>;
+    }) => Promise<Result | null>;
+    /** Updates multiple records matching the where conditions */
+    updateMany: <Model extends EntityName, Result extends TableFields<Model>>(data: {
+        model: Model;
+        where: Where<Model>;
+        update: Partial<EntityInput<Model>>;
+    }) => Promise<Result[]>;
+    /** Deletes a single record matching the where conditions */
+    delete: <Model extends EntityName>(data: {
+        model: Model;
+        where: Where<Model>;
+    }) => Promise<void>;
+    /** Deletes multiple records matching the where conditions */
+    deleteMany: <Model extends EntityName>(data: {
+        model: Model;
+        where: Where<Model>;
+    }) => Promise<number>;
+    /**
+     * Executes a function within a database transaction
+     *
+     * This method allows multiple database operations to be executed in a single atomic transaction.
+     * If any operation within the transaction fails, all operations are rolled back.
+     *
+     * @typeParam ResultType - The type of data returned by the transaction
+     * @param data - The transaction data containing the callback function
+     * @returns A promise that resolves with the result of the callback function
+     * @throws {Error} If the transaction fails to complete
+     *
+     * @example
+     * ```typescript
+     * const result = await adapter.transaction({
+     *   callback: async (tx) => {
+     *     const subject = await tx.create({
+     *       model: 'subject',
+     *       data: { name: 'John Doe' }
+     *     });
+     *     await tx.create({
+     *       model: 'profile',
+     *       data: { subjectId: subject.id, bio: 'Test bio' }
+     *     });
+     *     return subject;
+     *   }
+     * });
+     * ```
+     */
+    transaction: <ResultType>(data: {
+        callback: (transactionAdapter: Adapter) => Promise<ResultType>;
+    }) => Promise<ResultType>;
+    /** Optional method to create database schema */
+    createSchema?: (options: C15TOptions, file?: string) => Promise<AdapterSchemaCreation>;
+    /** Optional adapter-specific configuration */
+    options?: KyselyAdapterConfig | Record<string, unknown>;
+}
+/**
+ * Type definition for an adapter factory function
+ */
+export type AdapterInstance = (options: C15TOptions) => Adapter;
+//# sourceMappingURL=types.d.ts.map

package/dist/db/adapters/types.d.ts.map

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

package/dist/db/adapters/utils.d.ts

@@ -0,0 +1,36 @@
+import type { Field, Primitive } from '../core/fields/field-types';
+/**
+ * Applies the default value of a field if the provided value is undefined or null.
+ * Used in create and update operations to handle default values consistently.
+ *
+ * @typeParam PrimitiveValue - The primitive type of the field value
+ * @param inputValue - The input value provided for the field (may be undefined/null)
+ * @param field - The field definition containing the default value
+ * @param operation - The database operation being performed ('create' or 'update')
+ * @returns The original value, or the default value if applicable
+ *
+ * @remarks
+ * Default values are only applied:
+ * 1. During 'create' operations (not during updates)
+ * 2. When the input value is undefined or null
+ * 3. When the field has a defaultValue defined
+ *
+ * If the defaultValue is a function, it will be called to generate the value.
+ * This allows for dynamic default values such as timestamps, UUIDs, or any
+ * other values that need to be computed at runtime.
+ *
+ * @example
+ * ```typescript
+ * // Field with static default
+ * const nameField = { type: 'string', defaultValue: 'Anonymous' };
+ * applyDefaultValue(undefined, nameField, 'create'); // 'Anonymous'
+ * applyDefaultValue('Alice', nameField, 'create');   // 'Alice'
+ * applyDefaultValue(undefined, nameField, 'update'); // undefined
+ *
+ * // Field with dynamic default
+ * const createdField = { type: 'date', defaultValue: () => new Date() };
+ * applyDefaultValue(undefined, createdField, 'create'); // Current date
+ * ```
+ */
+export declare function applyDefaultValue(inputValue: Primitive, field: Field, operation: 'create' | 'update'): Primitive;
+//# sourceMappingURL=utils.d.ts.map

package/dist/db/adapters/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/db/adapters/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,iBAAiB,CAChC,UAAU,EAAE,SAAS,EACrB,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAC5B,SAAS,CAWX"}

package/dist/db/core/fields/field-factory.d.ts

@@ -0,0 +1,383 @@
+import type { InferValueType } from './field-inference';
+import type { Field, FieldConfig, FieldType, JsonValue, Primitive } from './field-types';
+/**
+ * Defines transform functions for field input and output operations.
+ * Provides properly typed transform functions based on the field type.
+ *
+ * @template TFieldType - The field type that determines the transform function signatures
+ *
+ * @example
+ * ```typescript
+ * // Define transform functions for a string field
+ * const nameTransformers: FieldTransformers<'string'> = {
+ *   input: (value) => value.trim(),
+ *   output: (value) => value.toUpperCase()
+ * };
+ * ```
+ */
+export type FieldTransformers<TFieldType extends FieldType> = {
+    /**
+     * Transform function for field input.
+     * Applied when data is being saved to the database.
+     */
+    input?: (value: InferValueType<TFieldType>) => Primitive | Promise<Primitive>;
+    /**
+     * Transform function for field output.
+     * Applied when data is being retrieved from the database.
+     */
+    output?: (value: InferValueType<TFieldType>) => Primitive | Promise<Primitive>;
+};
+/**
+ * Configuration options specific to number fields.
+ * Provides additional validation options for number fields.
+ *
+ * @example
+ * ```typescript
+ * // Define a number field with min/max constraints
+ * const ageField = numberField({
+ *   required: true,
+ *   min: 0,
+ *   max: 120
+ * });
+ * ```
+ */
+export type NumberFieldOptions = {
+    /**
+     * Minimum allowed value for the number field.
+     */
+    min?: number;
+    /**
+     * Maximum allowed value for the number field.
+     */
+    max?: number;
+};
+/**
+ * Configuration options specific to string fields.
+ * Provides additional validation options for string fields.
+ *
+ * @example
+ * ```typescript
+ * // Define a string field with length constraints
+ * const usernameField = stringField({
+ *   required: true,
+ *   minLength: 3,
+ *   maxLength: 20
+ * });
+ * ```
+ */
+export type StringFieldOptions = {
+    /**
+     * Minimum allowed length for the string field.
+     */
+    minLength?: number;
+    /**
+     * Maximum allowed length for the string field.
+     */
+    maxLength?: number;
+    /**
+     * Regular expression pattern that the string must match.
+     */
+    pattern?: string;
+};
+/**
+ * Configuration options specific to date fields.
+ * Provides additional validation and formatting options for date fields.
+ *
+ * @example
+ * ```typescript
+ * // Define a date field with min/max date constraints
+ * const birthdateField = dateField({
+ *   required: true,
+ *   minDate: new Date('1900-01-01'),
+ *   maxDate: new Date() // Current date
+ * });
+ * ```
+ */
+export type DateFieldOptions = {
+    /**
+     * Minimum allowed date value.
+     * Dates earlier than this will fail validation.
+     */
+    minDate?: Date;
+    /**
+     * Maximum allowed date value.
+     * Dates later than this will fail validation.
+     */
+    maxDate?: Date;
+    /**
+     * Whether to store just the date part without time information.
+     * When true, time components will be zeroed out.
+     * @default false
+     */
+    dateOnly?: boolean;
+    /**
+     * Format string for date output transformation.
+     * If provided, dates will be transformed to strings in this format.
+     * Only applies if no custom output transform is provided.
+     * Uses Intl.DateTimeFormat for consistent cross-platform formatting.
+     */
+    format?: Intl.DateTimeFormatOptions;
+};
+/**
+ * Configuration options specific to JSON fields.
+ * Provides additional validation and schema options for JSON data.
+ *
+ * @example
+ * ```typescript
+ * // Define a JSON field with schema validation
+ * const metadataField = jsonField({
+ *   required: true,
+ *   validator: (value) => {
+ *     if (!value.hasOwnProperty('version')) return 'Missing version property';
+ *     return null;
+ *   }
+ * });
+ * ```
+ */
+export type JsonFieldOptions = {
+    /**
+     * Whether to validate that the value is a valid JSON object.
+     * When true, the field will ensure the value can be properly stringified/parsed.
+     * @default true
+     */
+    validateJson?: boolean;
+};
+/**
+ * Common IANA timezone identifiers.
+ * A subset of commonly used timezones from the IANA timezone database.
+ * Used for validation and autocompletion in IDE.
+ */
+export declare const COMMON_TIMEZONES: {
+    readonly UTC: "UTC";
+    readonly GMT: "GMT";
+    readonly EASTERN: "America/New_York";
+    readonly CENTRAL: "America/Chicago";
+    readonly MOUNTAIN: "America/Denver";
+    readonly PACIFIC: "America/Los_Angeles";
+    readonly LONDON: "Europe/London";
+    readonly PARIS: "Europe/Paris";
+    readonly BERLIN: "Europe/Berlin";
+    readonly TOKYO: "Asia/Tokyo";
+    readonly SHANGHAI: "Asia/Shanghai";
+    readonly SINGAPORE: "Asia/Singapore";
+    readonly SYDNEY: "Australia/Sydney";
+    readonly SAO_PAULO: "America/Sao_Paulo";
+};
+/**
+ * Configuration options specific to timezone fields.
+ * Provides additional validation options for timezone fields.
+ *
+ * @example
+ * ```typescript
+ * // Define a timezone field with validation
+ * const tzField = timezoneField({
+ *   required: true,
+ *   defaultValue: COMMON_TIMEZONES.UTC
+ * });
+ *
+ * // Define a timezone field with suggested values
+ * const subjectTimezone = timezoneField({
+ *   required: true,
+ *   suggestedValues: [
+ *     COMMON_TIMEZONES.EASTERN,
+ *     COMMON_TIMEZONES.CENTRAL,
+ *     COMMON_TIMEZONES.PACIFIC
+ *   ]
+ * });
+ * ```
+ *
+ * @remarks
+ * The timezone field stores timezone identifiers according to the IANA timezone database.
+ * It validates timezone strings to ensure they are valid IANA timezone identifiers.
+ */
+export type TimezoneFieldOptions = {
+    /**
+     * Whether to validate the timezone format against IANA timezone database.
+     * When true, ensures the value is a valid IANA timezone name.
+     * @default true
+     */
+    validateTimezone?: boolean;
+    /**
+     * Suggested values for the timezone field.
+     * Can be used by client UIs to provide dropdown options.
+     */
+    suggestedValues?: string[] | readonly string[];
+    /**
+     * Whether to restrict values to only the provided suggestedValues.
+     * If true, values not in suggestedValues will fail validation.
+     * @default false
+     */
+    restrictToSuggestedValues?: boolean;
+};
+/**
+ * Creates a field attribute with the specified configuration.
+ * This is the core function for defining schema fields with type safety.
+ *
+ * @template TFieldType - The field type to create
+ * @template TConfig - The configuration type for the field
+ *
+ * @param type - The field type to create
+ * @param config - Configuration options for the field
+ * @returns A fully configured field definition
+ *
+ * @example
+ * ```typescript
+ * // Create a basic string field
+ * const nameField = createField('string', {
+ *   required: true
+ * });
+ *
+ * // Create a number field with transforms
+ * const ageField = createField('number', {
+ *   required: false,
+ *   transform: {
+ *     input: (value) => Math.floor(value)
+ *   }
+ * });
+ * ```
+ */
+export declare function createField<TFieldType extends FieldType>(type: TFieldType, config?: Omit<FieldConfig<TFieldType>, 'type'>): Field<TFieldType>;
+/**
+ * Creates a string field with the specified configuration.
+ */
+export declare function stringField<TConfig extends Omit<FieldConfig<'string'>, 'type' | 'transform'> & {
+    transform?: {
+        input?: (value: string) => Primitive | Promise<Primitive>;
+        output?: (value: unknown) => string | Promise<string>;
+    };
+} & StringFieldOptions>(config?: TConfig): Field<'string'>;
+/**
+ * Creates a number field with the specified configuration.
+ */
+export declare function numberField<TConfig extends Omit<FieldConfig<'number'>, 'type' | 'transform'> & {
+    transform?: {
+        input?: (value: number) => Primitive | Promise<Primitive>;
+        output?: (value: unknown) => number | Promise<number>;
+    };
+} & NumberFieldOptions>(config?: TConfig): Field<'number'>;
+/**
+ * Creates a boolean field with the specified configuration.
+ */
+export declare function booleanField<TConfig extends Omit<FieldConfig<'boolean'>, 'type' | 'transform'> & {
+    transform?: {
+        input?: (value: boolean) => Primitive | Promise<Primitive>;
+        output?: (value: unknown) => boolean | Promise<boolean>;
+    };
+}>(config?: TConfig): Field<'boolean'>;
+/**
+ * Creates a date field with the specified configuration.
+ */
+export declare function dateField<TConfig extends Omit<FieldConfig<'date'>, 'type' | 'transform' | 'minDate' | 'maxDate' | 'dateOnly' | 'format'> & {
+    transform?: {
+        input?: (value: Date) => Primitive | Promise<Primitive>;
+        output?: (value: unknown) => Date | Promise<Date>;
+    };
+} & DateFieldOptions>(config?: TConfig): Field<'date'>;
+/**
+ * Creates a timezone field with the specified configuration.
+ * Convenience wrapper around createField with timezone type.
+ *
+ * @template TConfig - The configuration type for the field
+ *
+ * @param config - Configuration options for the field
+ * @returns A fully configured timezone field definition
+ *
+ * @example
+ * ```typescript
+ * // Create a required timezone field with a default value
+ * const timezoneField = {
+ *   timezone: timezoneField({
+ *     required: true,
+ *     defaultValue: COMMON_TIMEZONES.UTC
+ *   })
+ * };
+ *
+ * // Create a timezone field with restricted values
+ * const regionTimezone = timezoneField({
+ *   required: true,
+ *   suggestedValues: [
+ *     COMMON_TIMEZONES.EASTERN,
+ *     COMMON_TIMEZONES.CENTRAL,
+ *     COMMON_TIMEZONES.MOUNTAIN,
+ *     COMMON_TIMEZONES.PACIFIC
+ *   ],
+ *   restrictToSuggestedValues: true
+ * });
+ * ```
+ *
+ * @remarks
+ * The timezone field stores timezone identifiers according to the IANA timezone database.
+ * It validates timezone strings to ensure they are valid IANA timezone identifiers.
+ */
+export declare function timezoneField<TConfig extends Omit<FieldConfig<'timezone'>, 'type' | 'transform'> & {
+    transform?: {
+        input?: (value: string) => string | Promise<string>;
+        output?: (value: unknown) => string | Promise<string>;
+    };
+} & TimezoneFieldOptions>(config?: TConfig): Field<'timezone'>;
+/**
+ * Creates a string array field with the specified configuration.
+ */
+export declare function stringArrayField<TConfig extends Omit<FieldConfig<'string[]'>, 'type' | 'transform'> & {
+    transform?: {
+        input?: (value: string[]) => Primitive | Promise<Primitive>;
+        output?: (value: unknown) => string[] | Promise<string[]>;
+    };
+}>(config?: TConfig): Field<'string[]'>;
+/**
+ * Creates a number array field with the specified configuration.
+ */
+export declare function numberArrayField<TConfig extends Omit<FieldConfig<'number[]'>, 'type' | 'transform'> & {
+    transform?: {
+        input?: (value: number[]) => Primitive | Promise<Primitive>;
+        output?: (value: unknown) => number[] | Promise<number[]>;
+    };
+}>(config?: TConfig): Field<'number[]'>;
+/**
+ * Creates a JSON field with the specified configuration.
+ */
+export declare function jsonField<TConfig extends Omit<FieldConfig<'json'>, 'type' | 'transform'> & {
+    transform?: {
+        input?: (value: JsonValue) => Primitive | Promise<Primitive>;
+        output?: (value: unknown) => JsonValue | Promise<JsonValue>;
+    };
+} & JsonFieldOptions>(config?: TConfig): Field<'json'>;
+/**
+ * Utility functions for working with dates and timezones.
+ * Provides helper methods for common date and timezone operations.
+ */
+export declare const DateTimeUtils: {
+    /**
+     * Creates a Date object in a specific timezone.
+     *
+     * @param dateInput - Date object or ISO string to convert
+     * @param timezone - Target timezone (IANA timezone identifier)
+     * @returns Date object adjusted for the specified timezone
+     */
+    createDateInTimezone: (dateInput: Date | string, timezone: string) => Date;
+    /**
+     * Formats a date according to the specified timezone.
+     *
+     * @param date - The date to format
+     * @param timezone - Target timezone (IANA timezone identifier)
+     * @param options - Formatting options for Intl.DateTimeFormat
+     * @returns Formatted date string in the specified timezone
+     */
+    formatInTimezone: (date: Date, timezone: string, options?: Intl.DateTimeFormatOptions) => string;
+    /**
+     * Gets the current date in a specific timezone.
+     *
+     * @param timezone - Target timezone (IANA timezone identifier)
+     * @returns Current date adjusted for the specified timezone
+     */
+    getNowInTimezone: (timezone: string) => Date;
+    /**
+     * Calculates the offset in minutes between the local timezone and the specified timezone.
+     *
+     * @param timezone - Target timezone (IANA timezone identifier)
+     * @param date - Optional date to calculate the offset for (defaults to current date)
+     * @returns Offset in minutes between local and specified timezone
+     */
+    getTimezoneOffset: (timezone: string, date?: Date) => number;
+};
+//# sourceMappingURL=field-factory.d.ts.map

package/dist/db/core/fields/field-factory.d.ts.map

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