/** * @debt circular "Remove & prevent imports from entity to schema" */ import type { UpdateValueInput } from '../../entity/actions/update/types.js'; import type { Paths, SchemaAction, ValidValue } from '../../schema/index.js'; import type { If, NarrowObject, Overwrite, ValueOrGetter } from '../../types/index.js'; import type { Always, AtLeastOnce, Never, Schema, SchemaProps, SchemaRequiredProp, Validator } from '../types/index.js'; import type { Light } from '../utils/light.js'; import { SetSchema } from './schema.js'; import type { SetElementSchema } from './types.js'; type SetSchemer = (elements: ELEMENTS, props?: NarrowObject) => SetSchema_, PROPS>; /** * Define a new set attribute * Note that set elements have constraints. They must be: * - Required (required: AtLeastOnce) * - Displayed (hidden: false) * - Not renamed (savedAs: undefined) * - Not defaulted (defaults: undefined) * * @param elements Attribute (With constraints) * @param props _(optional)_ List Props */ export declare const set: SetSchemer; /** * Set attribute interface */ export declare class SetSchema_ extends SetSchema { /** * Tag attribute as required. Possible values are: * - `'atLeastOnce'` _(default)_: Required in PUTs, optional in UPDATEs * - `'never'`: Optional in PUTs and UPDATEs * - `'always'`: Required in PUTs and UPDATEs * * @param nextRequired SchemaRequiredProp */ required(nextRequired?: NEXT_IS_REQUIRED): SetSchema_>; /** * Shorthand for `required('never')` */ optional(): SetSchema_>; /** * Hide attribute after fetch commands and formatting */ hidden(nextHidden?: NEXT_HIDDEN): SetSchema_>; /** * Tag attribute as a primary key attribute or linked to a primary attribute */ key(nextKey?: NEXT_KEY): SetSchema_>; /** * Rename attribute before save commands */ savedAs(nextSavedAs: NEXT_SAVED_AS): SetSchema_>; /** * Provide a default value for attribute in Primary Key computing * * @param nextKeyDefault `keyAttributeInput | (() => keyAttributeInput)` */ keyDefault(nextKeyDefault: ValueOrGetter>): SetSchema_>; /** * Provide a default value for attribute in PUT commands * * @param nextPutDefault `putAttributeInput | (() => putAttributeInput)` */ putDefault(nextPutDefault: ValueOrGetter>): SetSchema_>; /** * Provide a default value for attribute in UPDATE commands * * @param nextUpdateDefault `updateAttributeInput | (() => updateAttributeInput)` */ updateDefault(nextUpdateDefault: ValueOrGetter>): SetSchema_>; /** * Provide a default value for attribute in PUT commands OR Primary Key computing if attribute is tagged as key * * @param nextDefault `key/putAttributeInput | (() => key/putAttributeInput)` */ default(nextDefault: ValueOrGetter, ValidValue>>): If>, SetSchema_>>; /** * Provide a **linked** default value for attribute in Primary Key computing * * @param nextKeyLink `keyAttributeInput | ((keyInput) => keyAttributeInput)` */ keyLink(nextKeyLink: (keyInput: ValidValue) => ValidValue): SetSchema_>; /** * Provide a **linked** default value for attribute in PUT commands * * @param nextPutLink `putAttributeInput | ((putItemInput) => putAttributeInput)` */ putLink(nextPutLink: (putItemInput: ValidValue) => ValidValue): SetSchema_>; /** * Provide a **linked** default value for attribute in UPDATE commands * * @param nextUpdateLink `unknown | ((updateItemInput) => updateAttributeInput)` */ updateLink(nextUpdateLink: (updateItemInput: UpdateValueInput>) => UpdateValueInput): SetSchema_>; /** * Provide a **linked** default value for attribute in PUT commands OR Primary Key computing if attribute is tagged as key * * @param nextLink `key/putAttributeInput | (() => key/putAttributeInput)` */ link(nextLink: (keyOrPutItemInput: If, ValidValue>) => If, ValidValue>): If>, SetSchema_>>; /** * Provide a custom validator for attribute in Primary Key computing * * @param nextKeyValidator `(keyAttributeInput) => boolean | string` */ keyValidate(nextKeyValidator: Validator, this>): SetSchema_>; /** * Provide a custom validator for attribute in PUT commands * * @param nextPutValidator `(putAttributeInput) => boolean | string` */ putValidate(nextPutValidator: Validator, this>): SetSchema_>; /** * Provide a custom validator for attribute in UPDATE commands * * @param nextUpdateValidator `(updateAttributeInput) => boolean | string` */ updateValidate(nextUpdateValidator: Validator, this>): SetSchema_>; /** * Provide a custom validator for attribute in PUT commands OR Primary Key computing if attribute is tagged as key * * @param nextValidator `(key/putAttributeInput) => boolean | string` */ validate(nextValidator: Validator, ValidValue>, this>): If>, SetSchema_>>; clone(nextProps?: NarrowObject): SetSchema_>; build = SchemaAction>(Action: new (schema: this) => ACTION): ACTION; } export {};