@c15t/backend 0.0.1-rc.10

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

@@ -0,0 +1,218 @@
+import type { InferValueType as BaseInferValueType, Field, FieldType, Primitive } from './field-types';
+/**
+ * Infers the JavaScript type from a field type.
+ * Maps database field types to their corresponding TypeScript types.
+ *
+ * @template TFieldType - The field type to infer from
+ *
+ * @example
+ * ```typescript
+ * // Infer string type
+ * type NameType = InferValueType<'string'>;  // string
+ *
+ * // Infer array types
+ * type TagsType = InferValueType<'string[]'>;  // string[]
+ * type FlagsType = InferValueType<'boolean[]'>;  // boolean[]
+ * type DatesType = InferValueType<'date[]'>;  // Date[]
+ * ```
+ *
+ * @remarks
+ * This type handles both scalar types and array types.
+ * For arrays, it maps the base type to an array of that type.
+ * This approach is more maintainable and future-proof than
+ * explicitly handling each array type.
+ */
+export type InferValueType<TFieldType extends FieldType> = BaseInferValueType<TFieldType>;
+/**
+ * Infers the output type for a single field.
+ * Takes into account whether the field is required and returned in API responses.
+ *
+ * @template TField - The field definition
+ *
+ * @example
+ * ```typescript
+ * // A required string field
+ * const nameField: Field<'string'> = {
+ *   type: 'string',
+ *   required: true
+ * };
+ * type NameOutput = InferFieldOutput<typeof nameField>;  // string
+ *
+ * // An optional number field
+ * const ageField: Field<'number'> = {
+ *   type: 'number',
+ *   required: false
+ * };
+ * type AgeOutput = InferFieldOutput<typeof ageField>;  // number | null | undefined
+ * ```
+ *
+ * @remarks
+ * If a field has `returned: false`, this will be `never` indicating
+ * the field should not appear in API responses.
+ */
+export type InferFieldOutput<TField extends Field> = TField['returned'] extends false ? never : TField['required'] extends false ? InferValueType<TField['type']> | null | undefined : InferValueType<TField['type']>;
+/**
+ * Infers the input type for a single field.
+ * Determines the expected type when creating or updating records.
+ *
+ * @template TField - The field definition
+ *
+ * @example
+ * ```typescript
+ * // A non-input field (system-generated)
+ * const createdAtField: Field<'date'> = {
+ *   type: 'date',
+ *   required: true,
+ *   input: false
+ * };
+ * type CreatedAtInput = InferFieldInput<typeof createdAtField>;  // never
+ * ```
+ *
+ * @remarks
+ * If a field has `input: false`, this will be `never` indicating
+ * the field should not be provided in API requests.
+ */
+export type InferFieldInput<TField extends Field> = TField['input'] extends false ? never : TField['required'] extends true ? InferValueType<TField['type']> : InferValueType<TField['type']> | null | undefined;
+/**
+ * Type-safe property mapping helper for field outputs.
+ * Maps properties of a record type to their corresponding output types.
+ *
+ * @template TSchema - The record type containing field definitions
+ * @template TKey - The keys of TSchema to map
+ *
+ * @internal
+ * This is an internal helper type used by InferFieldsOutput
+ */
+/**
+ * Type helper to extract required keys from fields that should be returned.
+ * Identifies fields that are both required and returned in API responses.
+ *
+ * @template TSchema - The record type containing field definitions
+ *
+ * @internal
+ * Used to determine which fields must be present in output types
+ */
+type RequiredKeys<TSchema> = {
+    [Key in keyof TSchema]: TSchema[Key] extends Field ? TSchema[Key]['required'] extends true ? TSchema[Key]['returned'] extends false ? never : Key : never : never;
+}[keyof TSchema];
+/**
+ * Type helper to extract optional keys from fields that should be returned.
+ * Identifies fields that are optional but should be returned in API responses.
+ *
+ * @template TSchema - The record type containing field definitions
+ *
+ * @internal
+ * Used to determine which fields may be present in output types
+ */
+type OptionalKeys<TSchema> = {
+    [Key in keyof TSchema]: TSchema[Key] extends Field ? TSchema[Key]['required'] extends true ? never : TSchema[Key]['returned'] extends false ? never : Key : never;
+}[keyof TSchema];
+/**
+ * Type helper to extract required keys from fields that accept input.
+ * Identifies fields that are both required and accept subject input.
+ *
+ * @template TSchema - The record type containing field definitions
+ *
+ * @internal
+ * Used to determine which fields must be provided in create operations
+ */
+type RequiredInputKeys<TSchema> = {
+    [Key in keyof TSchema]: TSchema[Key] extends Field ? TSchema[Key]['required'] extends true ? TSchema[Key]['input'] extends false ? never : Key : never : never;
+}[keyof TSchema];
+/**
+ * Type helper to extract optional keys from fields that accept input.
+ * Identifies fields that are optional and accept subject input.
+ *
+ * @template TSchema - The record type containing field definitions
+ *
+ * @internal
+ * Used to determine which fields may be provided in create operations
+ */
+type OptionalInputKeys<TSchema> = {
+    [Key in keyof TSchema]: TSchema[Key] extends Field ? TSchema[Key]['required'] extends true ? never : TSchema[Key]['input'] extends false ? never : Key : never;
+}[keyof TSchema];
+/**
+ * Infers the output type shape for a set of fields.
+ * Handles required/optional status and returned fields.
+ * Used to determine the shape of data when retrieving records.
+ *
+ * @template TSchema - The field definitions to infer from
+ *
+ * @example
+ * ```typescript
+ * // Define a schema
+ * const subjectSchema = {
+ *   id: stringField({ required: true }),
+ *   name: stringField({ required: true }),
+ *   email: stringField({ required: true }),
+ *   age: numberField({ required: false }),
+ *   password: stringField({ required: true, returned: false })
+ * };
+ *
+ * // Infer the output type (for API responses)
+ * type SubjectOutput = InferFieldsOutput<typeof subjectSchema>;
+ * // Result: { id: string; name: string; email: string; age?: number | null | undefined }
+ * // Note: 'password' is excluded because returned: false
+ * ```
+ *
+ * @remarks
+ * This creates a type with:
+ * - Required properties for fields marked required and returned
+ * - Optional properties for fields marked optional and returned
+ * - Excludes fields marked with returned: false
+ */
+export type InferFieldsOutput<TSchema> = TSchema extends Record<string, Field> ? {
+    [Key in RequiredKeys<TSchema> & string]: InferFieldOutput<TSchema[Key]>;
+} & {
+    [Key in OptionalKeys<TSchema> & string]?: InferFieldOutput<TSchema[Key]>;
+} : Record<string, never>;
+/**
+ * Infers the input type shape for a set of fields.
+ * Handles required/optional status and input fields.
+ * Used to determine the shape of data expected when creating records.
+ *
+ * @template TSchema - The field definitions to infer from
+ *
+ * @example
+ * ```typescript
+ * // Define a schema
+ * const subjectSchema = {
+ *   id: stringField({ required: true, input: false }), // Auto-generated
+ *   name: stringField({ required: true }),
+ *   email: stringField({ required: true }),
+ *   age: numberField({ required: false }),
+ *   createdAt: dateField({ required: true, input: false })
+ * };
+ *
+ * // Infer the input type (for create operations)
+ * type SubjectInput = InferFieldsInput<typeof subjectSchema>;
+ * // Result: { name: string; email: string; age?: number | null | undefined }
+ * // Note: 'id' and 'createdAt' are excluded because input: false
+ * ```
+ *
+ * @remarks
+ * This creates a type with:
+ * - Required properties for fields marked required and input
+ * - Optional properties for fields marked optional and input
+ * - Excludes fields marked with input: false
+ */
+export type InferFieldsInput<TSchema> = TSchema extends Record<string, Field> ? {
+    [Key in RequiredInputKeys<TSchema> & string]: InferFieldInput<TSchema[Key]>;
+} & {
+    [Key in OptionalInputKeys<TSchema> & string]?: InferFieldInput<TSchema[Key]>;
+} : Record<string, never>;
+/**
+ * Type helper for transform function output based on field type.
+ * Ensures transform functions return the correct output type.
+ *
+ * @template TFieldType - The field type that determines the input parameter type
+ *
+ * @example
+ * ```typescript
+ * const dateTransform: TransformOutputFn<'date'> = (value) => value.toISOString();
+ * // value is typed as Date
+ * ```
+ */
+export type TransformOutputFn<TFieldType extends FieldType> = (value: InferValueType<TFieldType>) => Primitive | Promise<Primitive>;
+export {};
+//# sourceMappingURL=field-inference.d.ts.map

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

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

package/dist/db/core/fields/field-options-integration.d.ts

@@ -0,0 +1,90 @@
+import type { C15TOptions } from '../../../types';
+import type { InferFieldsInput, InferFieldsOutput } from './field-inference';
+import type { Field } from './field-types';
+/**
+ * Infers field types from plugin definitions in C15T options.
+ * Extracts and combines field definitions from enabled plugins.
+ *
+ * @template TOptions - The C15T options configuration type
+ * @template TSchemaKey - Key for accessing the specific entity schema within plugins
+ * @template TFormat - Format to return ('output' or 'input')
+ *
+ * @example
+ * ```typescript
+ * // Configuration with plugins defining consent fields
+ * interface MyOptions extends C15TOptions {
+ *   auth: {
+ *     plugins: {
+ *       consent: {
+ *         enabled: true,
+ *         subjectFields: {
+ *           acceptedTerms: {
+ *             type: 'boolean',
+ *             required: true
+ *           }
+ *         }
+ *       }
+ *     }
+ *   }
+ * }
+ *
+ * // Infer the output types for subject fields from plugins
+ * type SubjectPluginFields = InferFieldsFromPlugins<MyOptions, 'subjectFields', 'output'>;
+ * // Results in { acceptedTerms: boolean }
+ * ```
+ *
+ * @remarks
+ * This type helper allows plugins to extend entity schemas with their own fields.
+ * It walks through all enabled plugins, extracts fields for the specified entity type,
+ * and combines them into a single type.
+ */
+export type InferFieldsFromPlugins<TOptions extends C15TOptions, TSchemaKey extends string, TFormat extends 'output' | 'input' = 'output'> = InferFieldsFromObjectPath<TOptions, [
+    string,
+    'plugins',
+    string,
+    TSchemaKey
+], TFormat>;
+/**
+ * Infers field types from C15T options for a specific module.
+ * Used to extract additional fields defined in options.
+ *
+ * @template TOptions - The C15T options configuration type
+ * @template TSchemaKey - Key for accessing the specific entity schema
+ * @template TFormat - Format to return ('output' or 'input')
+ *
+ * @example
+ * ```typescript
+ * // Configuration with additional subject fields
+ * interface MyOptions extends C15TOptions {
+ *   auth: {
+ *     subjectFields: {
+ *       profile: {
+ *         type: 'string',
+ *         required: false
+ *       }
+ *     }
+ *   }
+ * }
+ *
+ * // Infer the output types for subject fields from options
+ * type SubjectAdditionalFields = InferFieldsFromOptions<MyOptions, 'subject', 'subjectFields', 'output'>;
+ * // Results in { profile?: string | null | undefined }
+ * ```
+ *
+ * @remarks
+ * TSchemaKey can be one of:
+ * - Single string key like 'subjectFields' to access TOptions[T]['subjectFields']
+ * - Array of strings for a nested path like ['subject', 'subjectFields']
+ *
+ * This type helper extracts custom fields defined directly in the options object,
+ * rather than those defined in plugins.
+ */
+export type InferFieldsFromOptions<TOptions extends C15TOptions, TModuleKey extends keyof TOptions & string, TSchemaKey extends string, TFormat extends 'output' | 'input' = 'output'> = InferFieldsFromObjectPath<TOptions, [TModuleKey, TSchemaKey], TFormat>;
+type InferFieldsFromObjectPath<TOptions, TPath extends (string | number)[], TFormat extends 'output' | 'input'> = TFormat extends 'output' ? InferFieldsOutput<GetFieldsFromPath<TOptions, TPath>> : InferFieldsInput<GetFieldsFromPath<TOptions, TPath>>;
+type GetFieldsFromPath<TOptions, TPath extends (string | number)[]> = TPath extends [infer TFirst, ...infer TRest] ? TFirst extends keyof TOptions ? TRest extends (string | number)[] ? TRest['length'] extends 0 ? TOptions[TFirst] extends Record<string, Field> ? TOptions[TFirst] : never : GetFieldsFromPath<TOptions[TFirst], TRest> : never : TFirst extends string ? TOptions extends Record<string, unknown> ? TRest extends (string | number)[] ? TRest['length'] extends 0 ? {
+    [K in keyof TOptions]: K extends TFirst ? TOptions[K] extends Record<string, Field> ? TOptions[K] : never : never;
+}[keyof TOptions & TFirst] : {
+    [K in keyof TOptions]: K extends TFirst ? GetFieldsFromPath<TOptions[K], TRest> : never;
+}[keyof TOptions & TFirst] : never : never : never : Record<string, never>;
+export {};
+//# sourceMappingURL=field-options-integration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"field-options-integration.d.ts","sourceRoot":"","sources":["../../../../src/db/core/fields/field-options-integration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,MAAM,sBAAsB,CACjC,QAAQ,SAAS,WAAW,EAC5B,UAAU,SAAS,MAAM,EACzB,OAAO,SAAS,QAAQ,GAAG,OAAO,GAAG,QAAQ,IAC1C,yBAAyB,CAC5B,QAAQ,EACR;IAAC,MAAM;IAAE,SAAS;IAAE,MAAM;IAAE,UAAU;CAAC,EACvC,OAAO,CACP,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,MAAM,sBAAsB,CACjC,QAAQ,SAAS,WAAW,EAC5B,UAAU,SAAS,MAAM,QAAQ,GAAG,MAAM,EAC1C,UAAU,SAAS,MAAM,EACzB,OAAO,SAAS,QAAQ,GAAG,OAAO,GAAG,QAAQ,IAC1C,yBAAyB,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;AAG3E,KAAK,yBAAyB,CAC7B,QAAQ,EACR,KAAK,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EACjC,OAAO,SAAS,QAAQ,GAAG,OAAO,IAC/B,OAAO,SAAS,QAAQ,GACzB,iBAAiB,CAAC,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,GACrD,gBAAgB,CAAC,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;AAGxD,KAAK,iBAAiB,CACrB,QAAQ,EACR,KAAK,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,IAC9B,KAAK,SAAS,CAAC,MAAM,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,GAC7C,MAAM,SAAS,MAAM,QAAQ,GAC5B,KAAK,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAChC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,GACxB,QAAQ,CAAC,MAAM,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAC7C,QAAQ,CAAC,MAAM,CAAC,GAChB,KAAK,GACN,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,GAC3C,KAAK,GACN,MAAM,SAAS,MAAM,GACpB,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvC,KAAK,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAChC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,GACxB;KACC,CAAC,IAAI,MAAM,QAAQ,GAAG,CAAC,SAAS,MAAM,GACpC,QAAQ,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GACxC,QAAQ,CAAC,CAAC,CAAC,GACX,KAAK,GACN,KAAK;CACR,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,GACzB;KACC,CAAC,IAAI,MAAM,QAAQ,GAAG,CAAC,SAAS,MAAM,GACpC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,GACrC,KAAK;CACR,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAC1B,KAAK,GACN,KAAK,GACN,KAAK,GACP,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC"}

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

@@ -0,0 +1,182 @@
+/**
+ * The set of field types supported by C15T.
+ * Specifies the data types that can be used for database fields.
+ *
+ * @remarks
+ * These types determine how data is stored, validated, and transformed.
+ * The system supports both scalar types and array types.
+ */
+export type FieldType = 'string' | 'number' | 'boolean' | 'date' | 'timezone' | 'json' | 'string[]' | 'number[]';
+/**
+ * Primitive types that can be stored in the database.
+ */
+export type Primitive = string | number | boolean | Date | null | undefined;
+/**
+ * JSON value types that can be stored in JSON fields.
+ */
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+/**
+ * Configuration options for a database field.
+ * Defines the behavior, validation, and transformations for a field.
+ *
+ * @template TFieldType - The data type of the field
+ *
+ * @example
+ * ```typescript
+ * // Basic required string field
+ * const basicConfig: FieldConfig<'string'> = {
+ *   type: 'string',
+ *   required: true
+ * };
+ *
+ * // Optional number field with validation
+ * const numberConfig: FieldConfig<'number'> = {
+ *   type: 'number',
+ *   required: false,
+ *   validator: (value) => value >= 0 ? null : 'Must be non-negative'
+ * };
+ *
+ * // Date field with transform and default
+ * const dateConfig: FieldConfig<'date'> = {
+ *   type: 'date',
+ *   defaultValue: () => new Date(),
+ *   transform: {
+ *     output: (date) => date.toISOString()
+ *   }
+ * };
+ * ```
+ *
+ * @remarks
+ * This is the core configuration object that defines how a field behaves
+ * in the database schema. It controls whether the field is required, how
+ * it's transformed, validated, and more.
+ */
+export type FieldConfig<TFieldType extends FieldType> = {
+    /**
+     * The data type of the field.
+     * Determines how the field is stored and validated.
+     */
+    type: TFieldType;
+    /**
+     * Whether the field is required for record creation.
+     * If true, the field must be provided when creating a record.
+     * @default true
+     */
+    required?: boolean;
+    /**
+     * Whether the field should be returned in API responses.
+     * If false, the field will be excluded from query results.
+     * @default true
+     */
+    returned?: boolean;
+    /**
+     * Whether the field accepts input from API requests.
+     * If false, the field cannot be set directly by clients.
+     * @default true
+     */
+    input?: boolean;
+    /**
+     * Default value for the field when not provided in create operations.
+     * Can be a static value or a function that returns a value.
+     */
+    defaultValue?: Primitive | (() => Primitive);
+    /**
+     * Functions to transform the field value during input/output operations.
+     * Can modify values before storage or after retrieval.
+     */
+    transform?: {
+        /**
+         * 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: unknown) => InferValueType<TFieldType> | Promise<InferValueType<TFieldType>>;
+    };
+    /**
+     * Custom validation function for the field.
+     * Returns null if valid, or an error message if invalid.
+     */
+    validator?: (value: InferValueType<TFieldType>) => string | null;
+    /**
+     * Whether the field should be unique across all records.
+     * If true, no two records can have the same value for this field.
+     */
+    unique?: boolean;
+    /**
+     * Whether the field should be indexed for faster lookups.
+     * If true, an index will be created for this field.
+     */
+    indexed?: boolean;
+    /**
+     * Whether the field should be sortable in queries.
+     * If false, the field cannot be used in ORDER BY clauses.
+     * @default true
+     */
+    sortable?: boolean;
+    /**
+     * Custom database field name.
+     * If not provided, the field name will be used as-is.
+     */
+    fieldName?: string;
+    /**
+     * Whether the field should be stored as a bigint.
+     * Only applicable to number fields.
+     * @default false
+     */
+    bigint?: boolean;
+    /**
+     * References to other models.
+     */
+    references?: {
+        model: string;
+        entity: string;
+        field: string;
+        onDelete: 'CASCADE' | 'SET NULL' | 'RESTRICT' | 'NO ACTION';
+    };
+};
+/**
+ * Helper type to infer the base JavaScript type from a field type.
+ */
+export type InferValueType<TFieldType extends FieldType> = TFieldType extends 'string' ? string : TFieldType extends 'number' ? number : TFieldType extends 'boolean' ? boolean : TFieldType extends 'date' ? Date : TFieldType extends 'timezone' ? string : TFieldType extends 'json' ? JsonValue : TFieldType extends 'string[]' ? string[] : TFieldType extends 'number[]' ? number[] : never;
+/**
+ * The complete definition of a database field.
+ * Combines the field type with its configuration options.
+ *
+ * @template TFieldType - The data type of the field
+ *
+ * @example
+ * ```typescript
+ * // A simple string field
+ * const nameField: Field<'string'> = {
+ *   type: 'string',
+ *   required: true,
+ *   unique: true
+ * };
+ *
+ * // A number field with validation
+ * const ageField: Field<'number'> = {
+ *   type: 'number',
+ *   required: true,
+ *   validator: (value) => value >= 0 ? null : 'Age must be non-negative'
+ * };
+ *
+ * // A date field with transforms
+ * const createdAtField: Field<'date'> = {
+ *   type: 'date',
+ *   required: true,
+ *   input: false,
+ *   defaultValue: () => new Date(),
+ *   transform: {
+ *     output: (date) => date.toISOString()
+ *   }
+ * };
+ * ```
+ */
+export type Field<TFieldType extends FieldType = FieldType> = FieldConfig<TFieldType>;
+//# sourceMappingURL=field-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"field-types.d.ts","sourceRoot":"","sources":["../../../../src/db/core/fields/field-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GAClB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,UAAU,GACV,MAAM,GACN,UAAU,GACV,UAAU,CAAC;AAEd;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC;AAE5E;;GAEG;AACH,MAAM,MAAM,SAAS,GAClB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,MAAM,WAAW,CAAC,UAAU,SAAS,SAAS,IAAI;IACvD;;;OAGG;IACH,IAAI,EAAE,UAAU,CAAC;IAEjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,YAAY,CAAC,EAAE,SAAS,GAAG,CAAC,MAAM,SAAS,CAAC,CAAC;IAE7C;;;OAGG;IACH,SAAS,CAAC,EAAE;QACX;;;WAGG;QACH,KAAK,CAAC,EAAE,CACP,KAAK,EAAE,cAAc,CAAC,UAAU,CAAC,KAC7B,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;QAEpC;;;WAGG;QACH,MAAM,CAAC,EAAE,CACR,KAAK,EAAE,OAAO,KACV,cAAc,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC;KACtE,CAAC;IAEF;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,UAAU,CAAC,KAAK,MAAM,GAAG,IAAI,CAAC;IAEjE;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;KAC5D,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,UAAU,SAAS,SAAS,IACtD,UAAU,SAAS,QAAQ,GACxB,MAAM,GACN,UAAU,SAAS,QAAQ,GAC1B,MAAM,GACN,UAAU,SAAS,SAAS,GAC3B,OAAO,GACP,UAAU,SAAS,MAAM,GACxB,IAAI,GACJ,UAAU,SAAS,UAAU,GAC5B,MAAM,GACN,UAAU,SAAS,MAAM,GACxB,SAAS,GACT,UAAU,SAAS,UAAU,GAC5B,MAAM,EAAE,GACR,UAAU,SAAS,UAAU,GAC5B,MAAM,EAAE,GACR,KAAK,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,MAAM,KAAK,CAAC,UAAU,SAAS,SAAS,GAAG,SAAS,IACzD,WAAW,CAAC,UAAU,CAAC,CAAC"}

package/dist/db/core/fields/id-generator.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Generates a unique ID with the specified prefix
+ *
+ * Creates time-ordered, prefixed, base58-encoded identifiers that:
+ * - Start with the provided prefix for clear identification
+ * - Embed a timestamp for chronological ordering
+ * - Include random data for uniqueness
+ *
+ * @param prefix - The prefix to use for the ID
+ * @returns A unique, prefixed identifier
+ *
+ * @example
+ * ```typescript
+ * const subjectId = generateId("sub"); // "sub_3hK4G..."
+ * const consentId = generateId("cns"); // "cns_5RtX9..."
+ * ```
+ */
+export declare function generateId(prefix: string): string;
+//# sourceMappingURL=id-generator.d.ts.map

package/dist/db/core/fields/id-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-generator.d.ts","sourceRoot":"","sources":["../../../../src/db/core/fields/id-generator.ts"],"names":[],"mappings":"AAeA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAwBjD"}

package/dist/db/core/fields/index.d.ts

@@ -0,0 +1,8 @@
+export type { FieldType, Field, FieldConfig, Primitive, JsonValue, } from './field-types';
+export type { NumberFieldOptions, StringFieldOptions, JsonFieldOptions, TimezoneFieldOptions, DateFieldOptions, } from './field-factory';
+export { createField, stringField, numberField, booleanField, dateField, jsonField, stringArrayField, numberArrayField, timezoneField, COMMON_TIMEZONES, } from './field-factory';
+export { validateField, createFieldValueSchema, } from './zod-fields';
+export type { InferFieldOutput, InferFieldInput, InferFieldsOutput, InferFieldsInput, TransformOutputFn, } from './field-inference';
+export { getDatabaseType, transformForDb, parseFromDb, } from './superjson-utils';
+export { generateId } from './id-generator';
+//# sourceMappingURL=index.d.ts.map

package/dist/db/core/fields/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/db/core/fields/index.ts"],"names":[],"mappings":"AACA,YAAY,EACX,SAAS,EACT,KAAK,EACL,WAAW,EACX,SAAS,EACT,SAAS,GACT,MAAM,eAAe,CAAC;AAGvB,YAAY,EACX,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,GAChB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACN,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACZ,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,gBAAgB,GAChB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACN,aAAa,EACb,sBAAsB,GACtB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACX,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,GACjB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACN,eAAe,EACf,cAAc,EACd,WAAW,GACX,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/db/core/fields/superjson-utils.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Database type enumeration
+ * Used to identify the current database type for data handling decisions
+ */
+export type DatabaseType = 'sqlite' | 'postgresql' | 'mysql' | 'unknown';
+/**
+ * Get the current database type from a provider string
+ *
+ * @param provider - The database provider string
+ * @returns The normalized database type
+ */
+export declare function normalizeDatabaseType(provider?: string): DatabaseType;
+/**
+ * Get the current database type
+ *
+ * @returns The current database type
+ */
+export declare function getDatabaseType(): DatabaseType;
+/**
+ * Apply database-specific transformations for JSON data
+ *
+ * @param value - The value to transform
+ * @param dbType - The database type (defaults to current global setting)
+ * @returns Transformed value appropriate for the database
+ */
+export declare function transformForDb<T>(value: T, dbType?: DatabaseType): T | string;
+/**
+ * Parse a value from the database using the global database type.
+ *
+ * @param value - The value from the database
+ * @returns Parsed value
+ */
+export declare function parseFromDb(value: unknown): unknown;
+//# sourceMappingURL=superjson-utils.d.ts.map

package/dist/db/core/fields/superjson-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"superjson-utils.d.ts","sourceRoot":"","sources":["../../../../src/db/core/fields/superjson-utils.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,GAAG,SAAS,CAAC;AAEzE;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,CAoBrE;AAKD;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC/B,KAAK,EAAE,CAAC,EACR,MAAM,GAAE,YAAkC,GACxC,CAAC,GAAG,MAAM,CAkBZ;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,WAYzC"}