@tailor-platform/sdk 2.0.1 → 2.2.0

package/dist/runtime/globals.d.mts

@@ -78,11 +78,4 @@ declare global {
     name: "TailorErrors";
     errors: TailorErrorItem[];
   }
-  /**
-   * Single-message error raised by the Tailor Platform Function runtime.
-   */
-  class TailorErrorMessage extends Error {
-    constructor(message: string);
-    name: "TailorErrorMessage";
-  }
 }

package/dist/runtime/workflow.d.mts

@@ -6,10 +6,8 @@
  * At runtime this delegates to `globalThis.tailor.workflow`. Use `mockWorkflow`
  * from `@tailor-platform/sdk/vitest` to mock these calls in unit tests.
  *
- * The canonical names (`startWorkflow`, `execJobFunction`,
- * `resumeWorkflowExecution`) mirror the public `tailor.v1` RPC vocabulary:
- * `Exec*` is a blocking call that returns the job's result, while `Start*`
- * returns only an execution ID.
+ * `execJobFunction` blocks until the job finishes and returns its result, while
+ * `startWorkflow` returns only an execution ID.
  * @example
  * import { workflow } from "@tailor-platform/sdk/runtime";
  *
@@ -69,9 +67,6 @@ interface PlatformWorkflowAPI {
   resumeWorkflowExecution(executionId: string): Promise<string>;
   /**
    * Executes a job function and returns its result via durable suspend/replay.
-   *
-   * Canonical name under the platform verb convention: `Exec*` blocks and
-   * returns the job's result, while `Start*` returns only an execution ID.
    * @param jobName - Job name as defined in the workflow
    * @param args - Arguments forwarded to the job
    * @param options - Optional execution options (e.g. `executionPolicyKey`)

package/dist/schema--xYWRGfe.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"schema--xYWRGfe.mjs","names":["parseInternal","parseFieldInternal"],"sources":["../src/runtime/field-parse.ts","../src/configure/types/field.ts","../src/configure/services/tailordb/schema.ts"],"sourcesContent":["import type { FieldMetadata, TailorFieldType } from \"#/configure/types/field.types\";\nimport type { TailorPrincipal } from \"#/runtime/types\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\nconst regex = {\n  uuid: /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,\n  date: /^(?<year>\\d{4})-(?<month>\\d{2})-(?<day>\\d{2})$/,\n  time: /^(?<hour>[01]\\d|2[0-3]):(?<minute>[0-5]\\d)$/,\n  datetime:\n    /^(?<year>\\d{4})-(?<month>\\d{2})-(?<day>\\d{2})[Tt](?<hour>[01]\\d|2[0-3]):(?<minute>[0-5]\\d):(?<second>[0-5]\\d|60)(\\.(?<fraction>\\d+))?(?<offset>[Zz]|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$/,\n  decimal: /^-?(\\d+\\.?\\d*|\\.\\d+)([eE][+-]?\\d+)?$/,\n} as const;\n\nexport type FieldParseArgs = {\n  value: unknown;\n  data: unknown;\n  invoker: TailorPrincipal | null;\n};\n\nexport type FieldParseInternalArgs = {\n  value: unknown;\n  data: unknown;\n  invoker: TailorPrincipal | null;\n  pathArray: string[];\n};\n\nexport type FieldRuntime<T extends TailorFieldType = TailorFieldType> = {\n  readonly type: T;\n  readonly fields: Record<string, FieldRuntime>;\n  _metadata: FieldMetadata;\n};\n\ntype FieldParseRuntimeArgs<T extends TailorFieldType> = FieldParseInternalArgs & {\n  field: FieldRuntime<T>;\n};\n\ntype FieldValidationArgs<T extends TailorFieldType> = FieldParseRuntimeArgs<T> & {\n  issues: StandardSchemaV1.Issue[];\n};\n\nfunction validateBaseValue<T extends TailorFieldType>(args: FieldValidationArgs<T>): boolean {\n  const { field, value, pathArray, issues } = args;\n  const path = pathArray.length > 0 ? pathArray : undefined;\n  const initialIssueCount = issues.length;\n\n  switch (field.type) {\n    case \"string\":\n      if (typeof value !== \"string\") {\n        issues.push({\n          message: `Expected a string: received ${String(value)}`,\n          path,\n        });\n      }\n      break;\n\n    case \"integer\":\n      if (typeof value !== \"number\" || !Number.isInteger(value)) {\n        issues.push({\n          message: `Expected an integer: received ${String(value)}`,\n          path,\n        });\n      }\n      break;\n\n    case \"float\":\n      if (typeof value !== \"number\" || !Number.isFinite(value)) {\n        issues.push({\n          message: `Expected a number: received ${String(value)}`,\n          path,\n        });\n      }\n      break;\n\n    case \"boolean\":\n      if (typeof value !== \"boolean\") {\n        issues.push({\n          message: `Expected a boolean: received ${String(value)}`,\n          path,\n        });\n      }\n      break;\n\n    case \"uuid\":\n      if (typeof value !== \"string\" || !regex.uuid.test(value)) {\n        issues.push({\n          message: `Expected a valid UUID: received ${String(value)}`,\n          path,\n        });\n      }\n      break;\n    case \"date\":\n      if (typeof value !== \"string\" || !regex.date.test(value)) {\n        issues.push({\n          message: `Expected to match \"yyyy-MM-dd\" format: received ${String(value)}`,\n          path,\n        });\n      }\n      break;\n    case \"datetime\":\n      if (typeof value !== \"string\" || !regex.datetime.test(value)) {\n        issues.push({\n          message: `Expected to match ISO format: received ${String(value)}`,\n          path,\n        });\n      }\n      break;\n    case \"time\":\n      if (typeof value !== \"string\" || !regex.time.test(value)) {\n        issues.push({\n          message: `Expected to match \"HH:mm\" format: received ${String(value)}`,\n          path,\n        });\n      }\n      break;\n    case \"decimal\":\n      if (typeof value !== \"string\" || !regex.decimal.test(value)) {\n        issues.push({\n          message: `Expected a decimal string: received ${String(value)}`,\n          path,\n        });\n      }\n      break;\n\n    case \"enum\":\n      if (field._metadata.allowedValues) {\n        const allowedValues = field._metadata.allowedValues.map((v) => v.value);\n        if (typeof value !== \"string\" || !allowedValues.includes(value)) {\n          issues.push({\n            message: `Must be one of [${allowedValues.join(\", \")}]: received ${String(value)}`,\n            path,\n          });\n        }\n      }\n      break;\n\n    case \"nested\": {\n      // Runtime input may not match the declared field type.\n      // oxlint-disable typescript/no-unnecessary-condition\n      if (\n        typeof value !== \"object\" ||\n        value === null ||\n        Array.isArray(value) ||\n        value instanceof Date\n      ) {\n        // oxlint-enable typescript/no-unnecessary-condition\n        issues.push({\n          message: `Expected an object: received ${String(value)}`,\n          path,\n        });\n        return false;\n      }\n\n      let nestedBaseValid = true;\n      for (const [fieldName, nestedField] of Object.entries(field.fields)) {\n        const fieldValue = (value as Record<string, unknown>)[fieldName];\n        if (\n          !validateBaseField({\n            ...args,\n            field: nestedField,\n            value: fieldValue,\n            pathArray: pathArray.concat(fieldName),\n          })\n        ) {\n          nestedBaseValid = false;\n        }\n      }\n      return nestedBaseValid;\n    }\n  }\n\n  return issues.length === initialIssueCount;\n}\n\nfunction validateCustomValue<T extends TailorFieldType>(\n  args: FieldValidationArgs<T>,\n  validateFns: NonNullable<FieldMetadata[\"validate\"]>,\n): void {\n  const { value, pathArray, issues } = args;\n  const path = pathArray.length > 0 ? pathArray : undefined;\n\n  for (const fn of validateFns) {\n    const result = fn({ value });\n    if (typeof result === \"string\") {\n      issues.push({\n        message: result,\n        path,\n      });\n    }\n  }\n}\n\nfunction validateBaseField<T extends TailorFieldType>(args: FieldValidationArgs<T>): boolean {\n  const { field, value, pathArray, issues } = args;\n  const path = pathArray.length > 0 ? pathArray : undefined;\n\n  const isNullOrUndefined = value === null || value === undefined;\n  if (field._metadata.required && isNullOrUndefined) {\n    issues.push({\n      message: \"Required field is missing\",\n      path,\n    });\n    return false;\n  }\n\n  if (!field._metadata.required && isNullOrUndefined) {\n    return true;\n  }\n\n  let baseValid = true;\n  if (field._metadata.array) {\n    if (!Array.isArray(value)) {\n      issues.push({\n        message: \"Expected an array\",\n        path,\n      });\n      return false;\n    }\n\n    for (let i = 0; i < value.length; i++) {\n      if (\n        !validateBaseValue({\n          ...args,\n          value: value[i],\n          pathArray: pathArray.concat(`[${i}]`),\n        })\n      ) {\n        baseValid = false;\n      }\n    }\n  } else {\n    baseValid = validateBaseValue(args);\n  }\n\n  return baseValid;\n}\n\nfunction validateCustomField<T extends TailorFieldType>(args: FieldValidationArgs<T>): void {\n  const { field, value, pathArray } = args;\n  if (value === null || value === undefined) {\n    return;\n  }\n\n  if (field.type === \"nested\") {\n    const records = field._metadata.array\n      ? (value as Record<string, unknown>[])\n      : [value as Record<string, unknown>];\n\n    for (let i = 0; i < records.length; i++) {\n      const record = records[i] as Record<string, unknown>;\n      const recordPath = field._metadata.array ? pathArray.concat(`[${i}]`) : pathArray;\n      for (const [fieldName, nestedField] of Object.entries(field.fields)) {\n        validateCustomField({\n          ...args,\n          field: nestedField,\n          value: record[fieldName],\n          pathArray: recordPath.concat(fieldName),\n        });\n      }\n    }\n  }\n\n  const validateFns = field._metadata.validate;\n  if (validateFns?.length) {\n    validateCustomValue(args, validateFns);\n  }\n}\n\nexport function parseInternal<T extends TailorFieldType, Output>(\n  args: FieldParseRuntimeArgs<T>,\n): StandardSchemaV1.Result<Output> {\n  const { value } = args;\n  const issues: StandardSchemaV1.Issue[] = [];\n  const validationArgs = { ...args, issues };\n  const baseValid = validateBaseField(validationArgs);\n  if (baseValid) {\n    validateCustomField(validationArgs);\n  }\n  if (issues.length > 0) {\n    return { issues };\n  }\n\n  return { value: (value ?? null) as Output };\n}\n\ntype ParseInputFieldsArgs = FieldParseArgs & {\n  fields: Record<string, FieldRuntime>;\n};\n\n/**\n * Validate a value against a record of input fields, treating the record as a\n * single required object — the same code path deployed functions run via\n * `t.object(fields).parse(...)`, so local validation matches platform behavior.\n * @param args - Input field definitions plus the value, context data, and user\n * @returns Validation result\n */\nexport function parseInputFields(args: ParseInputFieldsArgs): StandardSchemaV1.Result<unknown> {\n  const { fields, ...parseArgs } = args;\n  return parseInternal({\n    ...parseArgs,\n    field: { type: \"nested\", fields, _metadata: { required: true } },\n    pathArray: [],\n  });\n}\n","import type { EnumValue } from \"#/configure/types/field.types\";\n\nexport type AllowedValues = readonly [string | EnumValue, ...(string | EnumValue)[]];\n\n/**\n * Normalize allowed values into EnumValue objects with descriptions.\n * @param values - Allowed values as strings or EnumValue objects\n * @returns Normalized allowed values\n */\nexport function mapAllowedValues(values: AllowedValues): EnumValue[] {\n  return values.map((value) => {\n    if (typeof value === \"string\") {\n      return { value, description: \"\" };\n    }\n    return { ...value, description: value.description ?? \"\" };\n  });\n}\n\nexport type AllowedValuesOutput<V extends AllowedValues> = V[number] extends infer T\n  ? T extends string\n    ? T\n    : T extends { value: infer K }\n      ? K\n      : never\n  : never;\n","import { cloneDeep } from \"es-toolkit\";\nimport {\n  type AllowedValues,\n  type AllowedValuesOutput,\n  mapAllowedValues,\n} from \"#/configure/types/field\";\nimport {\n  parseInternal as parseFieldInternal,\n  type FieldParseArgs,\n  type FieldParseInternalArgs,\n} from \"#/runtime/field-parse\";\nimport { brandValue } from \"#/utils/brand\";\nimport type {\n  TailorDBField as TailorDBFieldBase,\n  TailorDBType as TailorDBTypeBase,\n  DBFieldMetadata,\n  DefinedDBFieldMetadata,\n  SerialConfig,\n  IndexDef,\n  TailorDBTypeMetadata,\n  RawRelationConfig,\n  RelationType,\n} from \"#/configure/services/tailordb/types\";\nimport type {\n  FieldOptions,\n  FieldOutput,\n  TailorFieldType,\n  TailorToTs,\n  FieldValidateInput,\n} from \"#/configure/types/field.types\";\nimport type { PluginAttachment, PluginConfigs } from \"#/plugin/types\";\nimport type { InferredAttributes } from \"#/runtime/types\";\nimport type { output, InferFieldsOutput, TypeLevelError } from \"#/types/helpers\";\nimport type { RawPermissions } from \"#/types/tailordb.generated\";\nimport type { TailorTypeGqlPermission, TailorTypePermission } from \"./permission\";\nimport type {\n  Hook,\n  TypeHook,\n  ExcludeNestedDBFields,\n  ExcludeHookedDBFields,\n  ExcludeDefaultedDBFields,\n  TypeFeatures,\n  TypeValidateFn,\n} from \"./types\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\n// Erased DB fields stay assignable across builder method-state changes.\n// oxlint-disable-next-line no-explicit-any\ntype AnyBuilderMethod = any;\n\nexport type TailorAnyDBField = Omit<\n  TailorDBFieldBase<AnyBuilderMethod, AnyBuilderMethod>,\n  \"fields\"\n> & {\n  readonly fields: Record<string, AnyBuilderMethod>;\n  _metadata: DBFieldMetadata;\n  parse: AnyBuilderMethod;\n  readonly typeName: TypeLevelError<string>;\n  description: AnyBuilderMethod;\n  relation: AnyBuilderMethod;\n  index: AnyBuilderMethod;\n  unique: AnyBuilderMethod;\n  vector: AnyBuilderMethod;\n  default: AnyBuilderMethod;\n  hooks: AnyBuilderMethod;\n  validate: AnyBuilderMethod;\n  serial: AnyBuilderMethod;\n  clone: AnyBuilderMethod;\n};\n\n// Helper alias\n// oxlint-disable-next-line no-explicit-any\nexport type TailorAnyDBType = TailorDBType<any, any, any>;\n\ntype IsAny<T> = 0 extends 1 & T ? true : false;\ntype DBFieldTypeNameMethod<Defined extends DefinedDBFieldMetadata> =\n  IsAny<Defined> extends true\n    ? TypeLevelError<string>\n    : TypeLevelError<\"typeName cannot be used on TailorDB fields\">;\n\ntype WithDBFieldDescription<Defined> = Defined & { description: true };\ntype WithDBFieldRelation<Defined, S extends RelationType | RelationSelfConfig> = S extends\n  | \"oneToOne\"\n  | \"1-1\"\n  ? Defined & { unique: true; index: true; relation: true }\n  : S extends { type: \"oneToOne\" | \"1-1\" }\n    ? Defined & { unique: true; index: true; relation: true }\n    : Defined & { index: true; relation: true };\ntype WithDBFieldIndex<Defined> = Defined & { index: true };\ntype WithDBFieldUnique<Defined> = Defined & { unique: true; index: true };\ntype WithDBFieldVector<Defined> = Defined & { vector: true };\ntype WithDBFieldHooks<Defined, H> = Defined & {\n  hooks: {\n    create: H extends { create: unknown } ? true : false;\n    update: H extends { update: unknown } ? true : false;\n  };\n  serial: false;\n};\ntype WithDBFieldDefault<Defined> = Defined & { default: true };\ntype WithDBFieldValidate<Defined> = Defined & { validate: true };\ntype WithDBFieldSerial<Defined> = Defined & {\n  serial: true;\n  hooks: { create: false; update: false };\n};\ntype WithDBFieldCloneOptions<Defined extends DefinedDBFieldMetadata, NewOpt extends FieldOptions> =\n  IsAny<Defined> extends true\n    ? Defined\n    : Omit<Defined, \"array\"> & {\n        array: NewOpt extends { array: true }\n          ? true\n          : NewOpt extends { array: false }\n            ? false\n            : Defined[\"array\"];\n      };\ntype NonNullableDBFieldOutput<Output> = Exclude<Output, null>;\ntype DBFieldScalarOutput<Output> =\n  NonNullableDBFieldOutput<Output> extends (infer Item)[] ? Item : NonNullableDBFieldOutput<Output>;\ntype DBFieldCloneArrayOutput<Output, NewOpt extends FieldOptions> = NewOpt extends {\n  array: true;\n}\n  ? DBFieldScalarOutput<Output>[]\n  : NewOpt extends { array: false }\n    ? DBFieldScalarOutput<Output>\n    : NonNullableDBFieldOutput<Output>;\ntype DBFieldCloneOutput<Output, NewOpt extends FieldOptions> = NewOpt extends { optional: true }\n  ? DBFieldCloneArrayOutput<Output, NewOpt> | null\n  : NewOpt extends { optional: false }\n    ? DBFieldCloneArrayOutput<Output, NewOpt>\n    : null extends Output\n      ? DBFieldCloneArrayOutput<Output, NewOpt> | null\n      : DBFieldCloneArrayOutput<Output, NewOpt>;\ntype DBFieldCloneOptions<Defined extends DefinedDBFieldMetadata> = Omit<FieldOptions, \"array\"> & {\n  array?: Defined extends { validate: unknown } ? Defined[\"array\"] : boolean;\n};\ntype InvalidValidatedArrayCloneKeys<\n  Fields extends Record<string, TailorAnyDBField>,\n  K extends keyof Fields,\n  Opt extends FieldOptions,\n> = Opt extends { array: infer ArrayOption }\n  ? {\n      [P in K]: Fields[P] extends TailorDBField<infer Defined, infer _Output>\n        ? Defined extends { validate: unknown }\n          ? ArrayOption extends Defined[\"array\"]\n            ? never\n            : P\n          : never\n        : never;\n    }[K]\n  : never;\ntype DBFieldsCloneOptionsGuard<\n  Fields extends Record<string, TailorAnyDBField>,\n  K extends keyof Fields,\n  Opt extends FieldOptions,\n> = [InvalidValidatedArrayCloneKeys<Fields, K, Opt>] extends [never]\n  ? unknown\n  : TypeLevelError<\"array cannot be changed on fields with custom validation\">;\ntype DefinedDBTypeMetadata = {\n  hooks?: true;\n  validate?: true;\n  features?: true;\n  indexes?: true;\n  files?: true;\n  permission?: true;\n  gqlPermission?: true;\n  description?: true;\n};\ntype WithDBTypeMetadata<\n  Defined extends DefinedDBTypeMetadata,\n  Key extends keyof DefinedDBTypeMetadata,\n> = Defined & Record<Key, true>;\ntype DBTypeDuplicateInputGuard<\n  Defined extends DefinedDBTypeMetadata,\n  Key extends keyof DefinedDBTypeMetadata,\n  Input,\n  Message extends string,\n> =\n  IsAny<Defined> extends true\n    ? Input\n    : Defined extends Record<Key, unknown>\n      ? TypeLevelError<Message>\n      : Input;\ntype DBTypeDuplicateRestGuard<\n  Defined extends DefinedDBTypeMetadata,\n  Key extends keyof DefinedDBTypeMetadata,\n  Input extends unknown[],\n  Message extends string,\n> =\n  IsAny<Defined> extends true\n    ? Input\n    : Defined extends Record<Key, unknown>\n      ? [TypeLevelError<Message>, ...TypeLevelError<Message>[]]\n      : Input;\ntype FileKeyConflictError<\n  Fields extends Record<string, TailorAnyDBField>,\n  User extends object,\n> = Partial<\n  Record<\n    keyof output<TailorDBType<Fields, User>> & string,\n    TypeLevelError<\"file keys cannot use existing field names\">\n  >\n>;\ntype DBFieldDescriptionFn<Defined extends DefinedDBFieldMetadata, Output> = (\n  description: string,\n) => TailorDBField<WithDBFieldDescription<Defined>, Output>;\ntype DBFieldRelationFn<Defined extends DefinedDBFieldMetadata, Output> = {\n  <S extends RelationType, T extends TailorAnyDBType>(\n    config: RelationConfig<S, T>,\n  ): TailorDBField<WithDBFieldRelation<Defined, S>, Output>;\n  <S extends RelationSelfConfig>(config: S): TailorDBField<WithDBFieldRelation<Defined, S>, Output>;\n};\ntype DBFieldIndexFn<Defined extends DefinedDBFieldMetadata, Output> = () => TailorDBField<\n  WithDBFieldIndex<Defined>,\n  Output\n>;\ntype DBFieldUniqueFn<Defined extends DefinedDBFieldMetadata, Output> = () => TailorDBField<\n  WithDBFieldUnique<Defined>,\n  Output\n>;\ntype DBFieldVectorFn<Defined extends DefinedDBFieldMetadata, Output> = () => TailorDBField<\n  WithDBFieldVector<Defined>,\n  Output\n>;\ntype DBFieldHooksFn<Defined extends DefinedDBFieldMetadata, Output> = <\n  const H extends Hook<\n    Output,\n    Defined extends { default: true } ? Output | null | undefined : Output\n  >,\n>(\n  hooks: H,\n) => TailorDBField<WithDBFieldHooks<Defined, H>, Output>;\ntype DBFieldValidateFn<Defined extends DefinedDBFieldMetadata, Output> = (\n  ...validate: FieldValidateInput<Output>[]\n) => TailorDBField<WithDBFieldValidate<Defined>, Output>;\ntype DBFieldSerialFn<Defined extends DefinedDBFieldMetadata, Output> = (\n  config: SerialConfig<Defined[\"type\"] & (\"integer\" | \"string\")>,\n) => TailorDBField<WithDBFieldSerial<Defined>, Output>;\ntype DBFieldDescriptionMethod<Defined extends DefinedDBFieldMetadata, Output> =\n  IsAny<Defined> extends true\n    ? DBFieldDescriptionFn<Defined, Output>\n    : Defined extends { description: unknown }\n      ? TypeLevelError<\".description() has already been set\">\n      : DBFieldDescriptionFn<Defined, Output>;\ntype DBFieldRelationMethod<Defined extends DefinedDBFieldMetadata, Output> =\n  IsAny<Defined> extends true\n    ? DBFieldRelationFn<Defined, Output>\n    : Defined extends { relation: unknown }\n      ? TypeLevelError<\".relation() has already been set\">\n      : DBFieldRelationFn<Defined, Output>;\ntype DBFieldArrayCheck<A extends boolean, Ok, Msg extends string> = A extends true\n  ? TypeLevelError<Msg>\n  : Ok;\ntype DBFieldIndexMethod<Defined extends DefinedDBFieldMetadata, Output> =\n  IsAny<Defined> extends true\n    ? DBFieldIndexFn<Defined, Output>\n    : Defined extends { index: unknown }\n      ? TypeLevelError<\".index() has already been set\">\n      : DBFieldArrayCheck<\n          Defined[\"array\"],\n          DBFieldIndexFn<Defined, Output>,\n          \"index cannot be set on array fields\"\n        >;\ntype DBFieldUniqueMethod<Defined extends DefinedDBFieldMetadata, Output> =\n  IsAny<Defined> extends true\n    ? DBFieldUniqueFn<Defined, Output>\n    : Defined extends { unique: unknown }\n      ? TypeLevelError<\".unique() has already been set\">\n      : DBFieldArrayCheck<\n          Defined[\"array\"],\n          DBFieldUniqueFn<Defined, Output>,\n          \"unique cannot be set on array fields\"\n        >;\ntype DBFieldVectorMethod<Defined extends DefinedDBFieldMetadata, Output> =\n  IsAny<Defined> extends true\n    ? DBFieldVectorFn<Defined, Output>\n    : Defined extends { vector: unknown }\n      ? TypeLevelError<\".vector() has already been set\">\n      : Defined extends { type: \"string\"; array: false }\n        ? DBFieldVectorFn<Defined, Output>\n        : TypeLevelError<\"vector can only be set on non-array string fields\">;\ntype DBFieldHooksMethod<Defined extends DefinedDBFieldMetadata, Output> =\n  IsAny<Defined> extends true\n    ? DBFieldHooksFn<Defined, Output>\n    : Defined extends {\n          serial: true;\n          hooks: { create: false; update: false };\n        }\n      ? TypeLevelError<\"hooks cannot be set after serial\">\n      : Defined extends {\n            hooks: unknown;\n          }\n        ? TypeLevelError<\".hooks() has already been set\">\n        : Defined extends { type: \"nested\" }\n          ? TypeLevelError<\"hooks cannot be set on nested type fields\">\n          : DBFieldHooksFn<Defined, Output>;\ntype DBFieldValidateMethod<Defined extends DefinedDBFieldMetadata, Output> =\n  IsAny<Defined> extends true\n    ? DBFieldValidateFn<Defined, Output>\n    : Defined extends { validate: unknown }\n      ? TypeLevelError<\".validate() has already been set\">\n      : DBFieldValidateFn<Defined, Output>;\ntype DBFieldSerialMethod<Defined extends DefinedDBFieldMetadata, Output> =\n  IsAny<Defined> extends true\n    ? DBFieldSerialFn<Defined, Output>\n    : Defined extends { serial: true }\n      ? TypeLevelError<\".serial() has already been set\">\n      : Defined extends { serial: false }\n        ? TypeLevelError<\"serial cannot be set after hooks\">\n        : IsAny<Output> extends true\n          ? Defined extends { type: \"integer\" | \"string\"; array: false }\n            ? DBFieldSerialFn<Defined, Output>\n            : TypeLevelError<\"serial can only be set on non-array integer or string fields\">\n          : null extends Output\n            ? TypeLevelError<\"serial can only be set on non-array integer or string fields\">\n            : Defined extends { type: \"integer\" | \"string\"; array: false }\n              ? DBFieldSerialFn<Defined, Output>\n              : TypeLevelError<\"serial can only be set on non-array integer or string fields\">;\ntype DBFieldDefaultFn<Defined extends DefinedDBFieldMetadata, Output> = (\n  value: Output extends null ? NonNullable<Output> : Output,\n) => TailorDBField<WithDBFieldDefault<Defined>, Output>;\ntype DBFieldDefaultMethod<Defined extends DefinedDBFieldMetadata, Output> =\n  IsAny<Defined> extends true\n    ? DBFieldDefaultFn<Defined, Output>\n    : Defined extends { default: unknown }\n      ? TypeLevelError<\".default() has already been set\">\n      : Defined extends { type: \"nested\" }\n        ? TypeLevelError<\"default cannot be set on nested type fields\">\n        : Defined extends { serial: true }\n          ? TypeLevelError<\"default cannot be set on serial fields\">\n          : null extends Output\n            ? TypeLevelError<\"default cannot be set on optional fields\">\n            : DBFieldDefaultFn<Defined, Output>;\n\n/**\n * Full TailorDBField interface with builder methods.\n * Extends the minimal structural interface from types/ with fluent API methods.\n */\nexport interface TailorDBField<\n  Defined extends DefinedDBFieldMetadata = DefinedDBFieldMetadata,\n  // oxlint-disable-next-line no-explicit-any\n  Output = any,\n> extends Omit<TailorDBFieldBase<Defined, Output>, \"fields\"> {\n  readonly fields: Record<string, TailorAnyDBField>;\n  _metadata: DBFieldMetadata;\n\n  /**\n   * Parse and validate a value against this field's validation rules\n   */\n  parse(args: FieldParseArgs): StandardSchemaV1.Result<Output>;\n\n  /**\n   * typeName is not available on TailorDB fields.\n   * Use typeName on pipeline fields (t.enum / t.object) instead.\n   */\n  typeName: DBFieldTypeNameMethod<Defined>;\n\n  /**\n   * Set a description for the field\n   */\n  description: DBFieldDescriptionMethod<Defined, Output>;\n\n  /**\n   * Define a relation to another type.\n   */\n  relation: DBFieldRelationMethod<Defined, Output>;\n\n  /**\n   * Add an index to the field\n   */\n  index: DBFieldIndexMethod<Defined, Output>;\n\n  /**\n   * Make the field unique (also adds an index)\n   */\n  unique: DBFieldUniqueMethod<Defined, Output>;\n\n  /**\n   * Enable vector search on the field (string type only)\n   */\n  vector: DBFieldVectorMethod<Defined, Output>;\n\n  /**\n   * Set a default value for the field on create. When the field is required,\n   * this makes it optional in the Create input — the default fills in when\n   * no value (or a nullish hook result) is provided.\n   *\n   * For datetime/date/time fields, pass `\"now\"` to use the operation timestamp.\n   */\n  default: DBFieldDefaultMethod<Defined, Output>;\n\n  /**\n   * Add hooks for create/update operations on this field.\n   */\n  hooks: DBFieldHooksMethod<Defined, Output>;\n\n  /**\n   * Add validation functions to the field.\n   *\n   * Validators receive `{ value, data, user }` and run after hooks and\n   * built-in type validation; they are skipped when built-in validation\n   * fails. For array fields, `value` is the complete array.\n   */\n  validate: DBFieldValidateMethod<Defined, Output>;\n\n  /**\n   * Configure serial/auto-increment behavior\n   */\n  serial: DBFieldSerialMethod<Defined, Output>;\n\n  /**\n   * Clone the field with optional overrides for field options.\n   * The `array` option cannot change on fields with custom validation.\n   */\n  clone<const NewOpt extends DBFieldCloneOptions<Defined>>(\n    options?: NewOpt,\n  ): TailorDBField<WithDBFieldCloneOptions<Defined, NewOpt>, DBFieldCloneOutput<Output, NewOpt>>;\n}\n\n/**\n * Full TailorDBType interface with builder methods.\n * Extends the minimal structural interface from types/ with fluent API methods.\n */\nexport interface TailorDBType<\n  // oxlint-disable-next-line no-explicit-any\n  Fields extends Record<string, TailorAnyDBField> = any,\n  User extends object = InferredAttributes,\n  // oxlint-disable-next-line no-explicit-any\n  Defined extends DefinedDBTypeMetadata = any,\n> extends TailorDBTypeBase<Fields, User> {\n  _description?: string;\n\n  hooks(\n    hook: DBTypeDuplicateInputGuard<\n      Defined,\n      \"hooks\",\n      TypeHook<Fields>,\n      \".hooks() has already been set\"\n    >,\n  ): TailorDBType<Fields, User, WithDBTypeMetadata<Defined, \"hooks\">>;\n  validate(\n    fn: DBTypeDuplicateInputGuard<\n      Defined,\n      \"validate\",\n      TypeValidateFn<Fields>,\n      \".validate() has already been set\"\n    >,\n  ): TailorDBType<Fields, User, WithDBTypeMetadata<Defined, \"validate\">>;\n  features(\n    features: DBTypeDuplicateInputGuard<\n      Defined,\n      \"features\",\n      Omit<TypeFeatures, \"pluralForm\">,\n      \".features() has already been set\"\n    >,\n  ): TailorDBType<Fields, User, WithDBTypeMetadata<Defined, \"features\">>;\n  indexes(\n    ...indexes: DBTypeDuplicateRestGuard<\n      Defined,\n      \"indexes\",\n      IndexDef<TailorDBType<Fields, User, Defined>>[],\n      \".indexes() has already been set\"\n    >\n  ): TailorDBType<Fields, User, WithDBTypeMetadata<Defined, \"indexes\">>;\n  files<const F extends string>(\n    files: DBTypeDuplicateInputGuard<\n      Defined,\n      \"files\",\n      Record<F, string> & FileKeyConflictError<Fields, User>,\n      \".files() has already been set\"\n    >,\n  ): TailorDBType<Fields, User, WithDBTypeMetadata<Defined, \"files\">>;\n  permission<\n    U extends object = User,\n    P extends TailorTypePermission<U, output<TailorDBType<Fields, User, Defined>>> =\n      TailorTypePermission<U, output<TailorDBType<Fields, User, Defined>>>,\n  >(\n    permission: DBTypeDuplicateInputGuard<\n      Defined,\n      \"permission\",\n      P,\n      \".permission() has already been set\"\n    >,\n  ): TailorDBType<Fields, U, WithDBTypeMetadata<Defined, \"permission\">>;\n  gqlPermission<\n    U extends object = User,\n    P extends TailorTypeGqlPermission<U> = TailorTypeGqlPermission<U>,\n  >(\n    permission: DBTypeDuplicateInputGuard<\n      Defined,\n      \"gqlPermission\",\n      P,\n      \".gqlPermission() has already been set\"\n    >,\n  ): TailorDBType<Fields, U, WithDBTypeMetadata<Defined, \"gqlPermission\">>;\n  description(\n    description: DBTypeDuplicateInputGuard<\n      Defined,\n      \"description\",\n      string,\n      \".description() has already been set\"\n    >,\n  ): TailorDBType<Fields, User, WithDBTypeMetadata<Defined, \"description\">>;\n  pickFields<K extends keyof Fields>(keys: K[]): Pick<Fields, K>;\n  pickFields<K extends keyof Fields, const Opt extends FieldOptions>(\n    keys: K[],\n    options: Opt & DBFieldsCloneOptionsGuard<Fields, K, Opt>,\n  ): {\n    [P in K]: Fields[P] extends TailorDBField<infer D, infer O>\n      ? TailorDBField<WithDBFieldCloneOptions<D, Opt>, DBFieldCloneOutput<O, Opt>>\n      : never;\n  };\n  omitFields<K extends keyof Fields>(keys: K[]): Omit<Fields, K>;\n  plugin<P extends keyof PluginConfigs<keyof Fields & string>>(config: {\n    [K in P]: PluginConfigs<keyof Fields & string>[K];\n  }): TailorDBType<Fields, User, Defined>;\n}\n\nexport type TailorDBInstance<\n  // oxlint-disable-next-line no-explicit-any\n  Fields extends Record<string, TailorAnyDBField> = any,\n  User extends object = InferredAttributes,\n  // oxlint-disable-next-line no-explicit-any\n  Defined extends DefinedDBTypeMetadata = any,\n> = TailorDBType<Fields, User, Defined>;\n\ninterface RelationConfig<S extends RelationType, T extends TailorDBType> {\n  type: S;\n  toward: {\n    type: T;\n    as?: string;\n    key?: keyof T[\"fields\"] & string;\n  };\n  backward?: string;\n}\n\n// Special config variant for self-referencing relations\ntype RelationSelfConfig = {\n  type: RelationType;\n  toward: {\n    type: \"self\";\n    as?: string;\n    key?: string;\n  };\n  backward?: string;\n};\n\nfunction isRelationSelfConfig(\n  config: RelationConfig<RelationType, TailorDBType> | RelationSelfConfig,\n): config is RelationSelfConfig {\n  return config.toward.type === \"self\";\n}\n\ntype DBFieldDefined<T extends TailorFieldType, Opt extends FieldOptions> = {\n  type: T;\n  array: Opt extends { array: true } ? true : false;\n};\ntype DBFieldOutput<\n  T extends TailorFieldType,\n  Opt extends FieldOptions,\n  OutputBase = TailorToTs[T],\n> = FieldOutput<OutputBase, Opt>;\ntype TailorDBFieldInstance<\n  T extends TailorFieldType,\n  Opt extends FieldOptions,\n  OutputBase = TailorToTs[T],\n> = TailorDBField<DBFieldDefined<T, Opt>, DBFieldOutput<T, Opt, OutputBase>>;\ntype TailorDBFieldRuntimeInstance<\n  T extends TailorFieldType,\n  Opt extends FieldOptions,\n  OutputBase = TailorToTs[T],\n> = TailorDBFieldRuntime<DBFieldDefined<T, Opt>, DBFieldOutput<T, Opt, OutputBase>>;\ntype TailorDBFieldRuntime<Defined extends DefinedDBFieldMetadata, Output> = Omit<\n  TailorDBFieldBase<Defined, Output>,\n  \"fields\"\n> & {\n  readonly fields: Record<string, TailorAnyDBField>;\n  _metadata: DBFieldMetadata;\n  description(description: string): object;\n  typeName(typeName: string): object;\n  validate(...validate: FieldValidateInput<Output>[]): object;\n  relation(config: RelationConfig<RelationType, TailorDBType> | RelationSelfConfig): object;\n  index(): object;\n  unique(): object;\n  vector(): object;\n  default(value: unknown): object;\n  hooks(hooks: Hook<Output>): object;\n  serial(config: SerialConfig): object;\n  clone(options?: FieldOptions): TailorDBFieldRuntime<DefinedDBFieldMetadata, AnyBuilderMethod>;\n  parse(args: FieldParseArgs): StandardSchemaV1.Result<Output>;\n  _setRawRelation(relation: RawRelationConfig): void;\n};\n\n/**\n * Creates a new TailorDBField instance.\n * @param type - Field type\n * @param options - Field options\n * @param fields - Nested fields for object-like types\n * @param values - Allowed values for enum-like fields\n * @returns A new TailorDBField\n */\nfunction createTailorDBField<\n  const T extends TailorFieldType,\n  const TOptions extends FieldOptions,\n  const OutputBase = TailorToTs[T],\n>(\n  type: T,\n  options?: TOptions,\n  fields?: Record<string, TailorAnyDBField>,\n  values?: AllowedValues,\n): TailorDBFieldInstance<T, TOptions, OutputBase>;\nfunction createTailorDBField<const T extends TailorFieldType, const TOptions extends FieldOptions>(\n  type: T,\n  options?: TOptions,\n  fields?: Record<string, TailorAnyDBField>,\n  values?: AllowedValues,\n): object {\n  return createTailorDBFieldRuntime(type, options, fields, values);\n}\n\nfunction createTailorDBFieldRuntime<\n  const T extends TailorFieldType,\n  const TOptions extends FieldOptions,\n  const OutputBase = TailorToTs[T],\n>(\n  type: T,\n  options?: TOptions,\n  fields?: Record<string, TailorAnyDBField>,\n  values?: AllowedValues,\n): TailorDBFieldRuntimeInstance<T, TOptions, OutputBase> {\n  type FieldValue = DBFieldOutput<T, TOptions, OutputBase>;\n  type FieldType = TailorDBFieldRuntimeInstance<T, TOptions, OutputBase>;\n\n  const _metadata: DBFieldMetadata = { required: true };\n  let _rawRelation: RawRelationConfig | undefined;\n\n  if (options) {\n    if (options.optional === true) {\n      _metadata.required = false;\n    }\n    if (options.array === true) {\n      _metadata.array = true;\n    }\n  }\n  if (values) {\n    _metadata.allowedValues = mapAllowedValues(values);\n  }\n\n  function parseInternal(args: FieldParseInternalArgs): StandardSchemaV1.Result<FieldValue> {\n    return parseFieldInternal<T, FieldValue>({\n      ...args,\n      field,\n    });\n  }\n\n  function cloneWith(metadataUpdates: Partial<DBFieldMetadata>) {\n    const cloned = field.clone();\n    Object.assign(cloned._metadata, metadataUpdates);\n    return cloned;\n  }\n\n  const field: FieldType = {\n    type,\n    fields: fields ?? {},\n    _defined: undefined as unknown as DBFieldDefined<T, TOptions>,\n    _output: undefined as FieldValue,\n    _metadata,\n\n    get metadata() {\n      return { ...this._metadata };\n    },\n\n    get rawRelation(): Readonly<RawRelationConfig> | undefined {\n      return _rawRelation ? { ..._rawRelation, toward: { ..._rawRelation.toward } } : undefined;\n    },\n\n    description(description: string) {\n      return cloneWith({ description });\n    },\n\n    typeName(typeName: string) {\n      return cloneWith({ typeName });\n    },\n\n    validate(...validateInputs: FieldValidateInput<FieldValue>[]) {\n      return cloneWith({ validate: validateInputs });\n    },\n\n    parse(args: FieldParseArgs): StandardSchemaV1.Result<FieldValue> {\n      return parseInternal({\n        value: args.value,\n        data: args.data,\n        invoker: args.invoker,\n        pathArray: [],\n      });\n    },\n\n    // TailorDBField specific methods\n    relation(config: RelationConfig<RelationType, TailorDBType> | RelationSelfConfig) {\n      const cloned = field.clone();\n      const targetType = isRelationSelfConfig(config) ? \"self\" : config.toward.type.name;\n      cloned._setRawRelation({\n        type: config.type,\n        toward: {\n          type: targetType,\n          as: config.toward.as,\n          key: config.toward.key,\n        },\n        backward: config.backward,\n      });\n      return cloned;\n    },\n\n    index() {\n      return cloneWith({ index: true });\n    },\n\n    unique() {\n      return cloneWith({ unique: true, index: true });\n    },\n\n    vector() {\n      return cloneWith({ vector: true });\n    },\n\n    // oxlint-disable-next-line no-explicit-any\n    default(value: any) {\n      // oxlint-disable-next-line no-explicit-any\n      return cloneWith({ default: value }) as any;\n    },\n\n    hooks(hooks: Hook<FieldValue>) {\n      return cloneWith({ hooks });\n    },\n\n    serial(config: SerialConfig) {\n      return cloneWith({ serial: config });\n    },\n\n    clone(cloneOptions?: FieldOptions) {\n      if (\n        this._metadata.validate?.length &&\n        cloneOptions?.array !== undefined &&\n        cloneOptions.array !== (this._metadata.array === true)\n      ) {\n        throw new Error(\"Cannot change the array option on a field with custom validation\");\n      }\n\n      // Deep clone nested object fields if present\n      let clonedFields = fields;\n      if (fields) {\n        const cloned: Record<string, TailorAnyDBField> = {};\n        for (const [key, field] of Object.entries(fields)) {\n          cloned[key] = field.clone();\n        }\n        clonedFields = cloned;\n      }\n\n      // Create a new field with cloned configuration\n      const clonedField = createTailorDBFieldRuntime(type, options, clonedFields, values);\n\n      // Deep copy metadata using cloneDeep (preserves function references)\n      Object.assign(clonedField._metadata, cloneDeep(this._metadata));\n\n      // Apply new options if provided\n      if (cloneOptions) {\n        if (cloneOptions.optional !== undefined) {\n          clonedField._metadata.required = !cloneOptions.optional;\n        }\n        if (cloneOptions.array !== undefined) {\n          clonedField._metadata.array = cloneOptions.array;\n        }\n      }\n\n      // Copy raw relation if exists\n      if (_rawRelation) {\n        clonedField._setRawRelation(cloneDeep(_rawRelation));\n      }\n\n      return clonedField;\n    },\n\n    _setRawRelation(relation: RawRelationConfig) {\n      _rawRelation = relation;\n    },\n  };\n\n  return field;\n}\n\nconst createField = createTailorDBField;\n\n/**\n * Create a UUID field.\n * @param options - Field configuration options\n * @returns A UUID field\n * @example db.uuid()\n * @example db.uuid({ optional: true })\n */\nfunction uuid<const Opt extends FieldOptions>(options?: Opt) {\n  return createField(\"uuid\", options);\n}\n\n/**\n * Create a string field.\n * @param options - Field configuration options\n * @returns A string field\n * @example db.string()\n * @example db.string({ optional: true })\n */\nfunction string<const Opt extends FieldOptions>(options?: Opt) {\n  return createField(\"string\", options);\n}\n\n/**\n * Create a boolean field.\n * Note: The method name is `bool` but creates a `boolean` type field.\n * @param options - Field configuration options\n * @returns A boolean field\n * @example db.bool()\n * @example db.bool({ optional: true })\n */\nfunction bool<const Opt extends FieldOptions>(options?: Opt) {\n  return createField(\"boolean\", options);\n}\n\n/**\n * Create an integer field.\n * @param options - Field configuration options\n * @returns An integer field\n * @example db.int()\n * @example db.int({ optional: true })\n */\nfunction int<const Opt extends FieldOptions>(options?: Opt) {\n  return createField(\"integer\", options);\n}\n\n/**\n * Create a float (decimal number) field.\n * @param options - Field configuration options\n * @returns A float field\n * @example db.float()\n * @example db.float({ optional: true })\n */\nfunction float<const Opt extends FieldOptions>(options?: Opt) {\n  return createField(\"float\", options);\n}\n\ninterface DecimalFieldOptions extends FieldOptions {\n  scale?: number;\n}\n\n/**\n * Create a decimal field (stored as string for precision).\n * @param options - Field configuration options including optional scale (0-12)\n * @returns A decimal field\n * @example db.decimal()\n * @example db.decimal({ scale: 2 })\n * @example db.decimal({ scale: 2, optional: true })\n */\nfunction decimal<const Opt extends DecimalFieldOptions>(options?: Opt) {\n  if (options?.scale !== undefined) {\n    if (!Number.isInteger(options.scale) || options.scale < 0 || options.scale > 12) {\n      throw new Error(\"scale must be an integer between 0 and 12\");\n    }\n  }\n  const field = createField(\"decimal\", options);\n  if (options?.scale !== undefined) {\n    field._metadata.scale = options.scale;\n  }\n  return field;\n}\n\n/**\n * Create a date field (date only, no time component).\n * Format: \"yyyy-MM-dd\"\n * @param options - Field configuration options\n * @returns A date field\n * @example db.date()\n */\nfunction date<const Opt extends FieldOptions>(options?: Opt) {\n  return createField(\"date\", options);\n}\n\n/**\n * Create a datetime field (date and time).\n * Format: ISO 8601, such as \"yyyy-MM-ddTHH:mm:ssZ\" or \"yyyy-MM-ddTHH:mm:ss+09:00\"\n * @param options - Field configuration options\n * @returns A datetime field\n * @example db.datetime()\n */\nfunction datetime<const Opt extends FieldOptions>(options?: Opt) {\n  return createField(\"datetime\", options);\n}\n\n/**\n * Create a time field (time only, no date component).\n * Format: \"HH:mm\"\n * @param options - Field configuration options\n * @returns A time field\n * @example db.time()\n */\nfunction time<const Opt extends FieldOptions>(options?: Opt) {\n  return createField(\"time\", options);\n}\n\n/**\n * Create an enum field with a fixed set of allowed string values.\n * @param values - Array of allowed string values, or array of `{ value, description }` objects\n * @param options - Field configuration options\n * @returns An enum field\n * @example db.enum([\"active\", \"inactive\", \"suspended\"])\n * @example db.enum([\"small\", \"medium\", \"large\"], { optional: true })\n */\nfunction _enum<const V extends AllowedValues, const Opt extends FieldOptions>(\n  values: V,\n  options?: Opt,\n): TailorDBField<\n  { type: \"enum\"; array: Opt extends { array: true } ? true : false },\n  FieldOutput<AllowedValuesOutput<V>, Opt>\n> {\n  return createField<\"enum\", Opt, AllowedValuesOutput<V>>(\"enum\", options, undefined, values);\n}\n\n/**\n * Create a nested object field with sub-fields.\n * @param fields - Record of nested field definitions\n * @param options - Field configuration options\n * @returns A nested object field\n * @example db.object({ street: db.string(), city: db.string(), zip: db.string() })\n * @example db.object({ name: db.string() }, { optional: true })\n */\nfunction object<\n  const F extends Record<string, TailorAnyDBField> &\n    ExcludeNestedDBFields<F> &\n    ExcludeHookedDBFields<F> &\n    ExcludeDefaultedDBFields<F>,\n  const Opt extends FieldOptions,\n>(fields: F, options?: Opt) {\n  return createField(\"nested\", options, fields) as unknown as TailorDBField<\n    { type: \"nested\"; array: Opt extends { array: true } ? true : false },\n    FieldOutput<InferFieldsOutput<F>, Opt>\n  >;\n}\n\n/**\n * Creates a new TailorDBType instance.\n * @param name - Type name\n * @param fields - Field definitions\n * @param options - Type options\n * @param options.pluralForm - Optional plural form\n * @param options.description - Optional description\n * @returns A new TailorDBType\n */\nfunction createTailorDBType<\n  // oxlint-disable-next-line no-explicit-any\n  const Fields extends Record<string, TailorAnyDBField> = any,\n  User extends object = InferredAttributes,\n>(\n  name: string,\n  fields: Fields,\n  options: { pluralForm?: string; description?: string },\n): TailorDBType<Fields, User, DefinedDBTypeMetadata> {\n  let _description = options.description;\n  let _settings: TypeFeatures = {};\n  let _indexes: IndexDef<TailorDBType<Fields, User, DefinedDBTypeMetadata>>[] = [];\n  const _permissions: RawPermissions = {};\n  let _files: Record<string, string> = {};\n  const _plugins: PluginAttachment[] = [];\n  // oxlint-disable-next-line typescript/no-unsafe-function-type\n  let _typeHook: { create?: Function; update?: Function } | undefined;\n  // oxlint-disable-next-line typescript/no-unsafe-function-type\n  let _typeValidate: Function | undefined;\n  const _definedMethods = new Set<keyof DefinedDBTypeMetadata>();\n  if (options.description !== undefined) {\n    _definedMethods.add(\"description\");\n  }\n\n  function runMethodOnce<T>(method: keyof DefinedDBTypeMetadata, action: () => T): T {\n    if (_definedMethods.has(method)) {\n      throw new Error(`.${method}() has already been set`);\n    }\n    const result = action();\n    _definedMethods.add(method);\n    return result;\n  }\n  type TypeAfter<Key extends keyof DefinedDBTypeMetadata> = TailorDBType<\n    Fields,\n    User,\n    WithDBTypeMetadata<DefinedDBTypeMetadata, Key>\n  >;\n  type TypeAfterUser<\n    NextUser extends object,\n    Key extends keyof DefinedDBTypeMetadata,\n  > = TailorDBType<Fields, NextUser, WithDBTypeMetadata<DefinedDBTypeMetadata, Key>>;\n\n  if (options.pluralForm) {\n    if (name === options.pluralForm) {\n      throw new Error(`The name and the plural form must be different. name=${name}`);\n    }\n    _settings.pluralForm = options.pluralForm;\n  }\n\n  const dbType: TailorDBType<Fields, User, DefinedDBTypeMetadata> = {\n    name,\n    fields: { ...fields },\n    _output: null as unknown as InferFieldsOutput<Fields>,\n    _description,\n\n    get metadata(): TailorDBTypeMetadata {\n      // Convert indexes to the format expected by the manifest\n      const indexes: Record<string, { fields: string[]; unique?: boolean }> = {};\n      if (_indexes.length > 0) {\n        _indexes.forEach((index) => {\n          const fieldNames = index.fields.map((field) => String(field));\n          const key = index.name || `idx_${fieldNames.join(\"_\")}`;\n          indexes[key] = {\n            fields: fieldNames,\n            unique: index.unique,\n          };\n        });\n      }\n\n      return {\n        name: this.name,\n        description: _description,\n        settings: _settings,\n        permissions: _permissions,\n        files: _files,\n        ...(Object.keys(indexes).length > 0 && { indexes }),\n        ...(_typeHook && { typeHook: _typeHook }),\n        ...(_typeValidate && { typeValidate: _typeValidate }),\n      };\n    },\n\n    hooks(hook: TypeHook<Fields>): TypeAfter<\"hooks\"> {\n      return runMethodOnce(\"hooks\", () => {\n        _typeHook = hook;\n        return this as TypeAfter<\"hooks\">;\n      });\n    },\n\n    validate(fn: TypeValidateFn<Fields>): TypeAfter<\"validate\"> {\n      return runMethodOnce(\"validate\", () => {\n        _typeValidate = fn;\n        return this as TypeAfter<\"validate\">;\n      });\n    },\n\n    features(features: Omit<TypeFeatures, \"pluralForm\">): TypeAfter<\"features\"> {\n      return runMethodOnce(\"features\", () => {\n        _settings = {\n          ..._settings,\n          ...features,\n        };\n        return this as TypeAfter<\"features\">;\n      });\n    },\n\n    indexes(\n      ...indexes: IndexDef<TailorDBType<Fields, User, DefinedDBTypeMetadata>>[]\n    ): TypeAfter<\"indexes\"> {\n      return runMethodOnce(\"indexes\", () => {\n        _indexes = indexes;\n        return this as TypeAfter<\"indexes\">;\n      });\n    },\n\n    files<const F extends string>(\n      files: Record<F, string> & FileKeyConflictError<Fields, User>,\n    ): TypeAfter<\"files\"> {\n      return runMethodOnce(\"files\", () => {\n        _files = files;\n        return this as TypeAfter<\"files\">;\n      });\n    },\n\n    permission<\n      U extends object = User,\n      P extends TailorTypePermission<U, output<TailorDBType<Fields, User, DefinedDBTypeMetadata>>> =\n        TailorTypePermission<U, output<TailorDBType<Fields, User, DefinedDBTypeMetadata>>>,\n    >(permission: P): TypeAfterUser<U, \"permission\"> {\n      return runMethodOnce(\"permission\", () => {\n        const ret = this as unknown as TypeAfterUser<U, \"permission\">;\n        _permissions.record = permission as RawPermissions[\"record\"];\n        return ret;\n      });\n    },\n\n    gqlPermission<\n      U extends object = User,\n      P extends TailorTypeGqlPermission<U> = TailorTypeGqlPermission<U>,\n    >(permission: P): TypeAfterUser<U, \"gqlPermission\"> {\n      return runMethodOnce(\"gqlPermission\", () => {\n        const ret = this as unknown as TypeAfterUser<U, \"gqlPermission\">;\n        _permissions.gql = permission as RawPermissions[\"gql\"];\n        return ret;\n      });\n    },\n\n    description(description: string): TypeAfter<\"description\"> {\n      return runMethodOnce(\"description\", () => {\n        _description = description;\n        this._description = description;\n        return this as TypeAfter<\"description\">;\n      });\n    },\n\n    pickFields<K extends keyof Fields, const Opt extends FieldOptions>(keys: K[], options?: Opt) {\n      const result = {} as Record<K, TailorAnyDBField>;\n      for (const key of keys) {\n        const field = this.fields[key] as TailorAnyDBField;\n        if (options) {\n          result[key] = field.clone(options);\n        } else {\n          result[key] = field;\n        }\n      }\n      // oxlint-disable-next-line no-explicit-any\n      return result as any;\n    },\n\n    omitFields<K extends keyof Fields>(keys: K[]): Omit<Fields, K> {\n      const keysSet = new Set(keys);\n      const result = {} as Record<string, TailorAnyDBField>;\n      for (const key in this.fields) {\n        if (Object.hasOwn(this.fields, key) && !keysSet.has(key as unknown as K)) {\n          result[key] = this.fields[key] as TailorAnyDBField;\n        }\n      }\n      return result as Omit<Fields, K>;\n    },\n\n    get plugins(): PluginAttachment[] {\n      return _plugins;\n    },\n\n    plugin<P extends keyof PluginConfigs<keyof Fields & string>>(config: {\n      [K in P]: PluginConfigs<keyof Fields & string>[K];\n    }): TailorDBType<Fields, User, AnyBuilderMethod> {\n      for (const [pluginId, pluginConfig] of Object.entries(config)) {\n        _plugins.push({ pluginId, config: pluginConfig });\n      }\n      return this;\n    },\n  };\n\n  return brandValue(dbType, \"tailordb-type\");\n}\n\nconst idField = uuid();\ntype idField = typeof idField;\ntype DBTable<\n  F extends { id?: never } & Record<string, TailorAnyDBField>,\n  Defined extends DefinedDBTypeMetadata = DefinedDBTypeMetadata,\n> = TailorDBInstance<{ id: idField } & F, InferredAttributes, Defined>;\n\n/**\n * Creates a new database table with the specified fields.\n * An `id` field (UUID) is automatically added to every table.\n * @param name - The name of the table, or a tuple of [name, pluralForm]\n * @param fields - The field definitions for the table\n * @returns A new TailorDB table instance\n * @example\n * export const user = db.table(\"User\", {\n *   name: db.string(),\n *   email: db.string(),\n *   age: db.int({ optional: true }),\n *   role: db.enum([\"admin\", \"member\"]),\n *   ...db.fields.timestamps(),\n * });\n * // Always export both the value and type:\n * export type user = typeof user;\n */\nfunction dbTable<const F extends { id?: never } & Record<string, TailorAnyDBField>>(\n  name: string | [string, string],\n  fields: F,\n): DBTable<F>;\n/**\n * Creates a new database table with the specified fields and description.\n * An `id` field (UUID) is automatically added to every table.\n * @param name - The name of the table, or a tuple of [name, pluralForm]\n * @param description - A description of the table\n * @param fields - The field definitions for the table\n * @returns A new TailorDB table instance\n */\nfunction dbTable<const F extends { id?: never } & Record<string, TailorAnyDBField>>(\n  name: string | [string, string],\n  description: string,\n  fields: F,\n): DBTable<F, WithDBTypeMetadata<DefinedDBTypeMetadata, \"description\">>;\nfunction dbTable<const F extends { id?: never } & Record<string, TailorAnyDBField>>(\n  name: string | [string, string],\n  fieldsOrDescription: string | F,\n  fields?: F,\n): DBTable<F> | DBTable<F, WithDBTypeMetadata<DefinedDBTypeMetadata, \"description\">> {\n  const typeName = Array.isArray(name) ? name[0] : name;\n  const pluralForm = Array.isArray(name) ? name[1] : undefined;\n\n  let description: string | undefined;\n  let fieldDef: F;\n  if (typeof fieldsOrDescription === \"string\") {\n    description = fieldsOrDescription;\n    fieldDef = fields as F;\n  } else {\n    fieldDef = fieldsOrDescription;\n  }\n  return createTailorDBType<{ id: idField } & F>(\n    typeName,\n    {\n      id: idField,\n      ...fieldDef,\n    },\n    { pluralForm, description },\n  ) as DBTable<F>;\n}\n\n/** TailorDB schema builder utilities for defining tables and fields. */\nexport const db = {\n  table: dbTable,\n  uuid,\n  string,\n  bool,\n  int,\n  float,\n  decimal,\n  date,\n  datetime,\n  time,\n  enum: _enum,\n  object,\n  fields: {\n    /**\n     * Creates standard timestamp fields (createdAt, updatedAt) with automatic defaults.\n     * Both fields default to the current time on create. updatedAt is also refreshed on update.\n     * User-specified values are respected when provided (e.g. seeding historical records).\n     * @returns An object with createdAt and updatedAt fields\n     * @example\n     * const model = db.table(\"Model\", {\n     *   name: db.string(),\n     *   ...db.fields.timestamps(),\n     * });\n     */\n    timestamps: () => ({\n      createdAt: datetime().default(\"now\").description(\"Record creation timestamp\"),\n      updatedAt: datetime()\n        .default(\"now\")\n        .hooks({ update: ({ input, now }) => input ?? now })\n        .description(\"Record update timestamp\"),\n    }),\n  },\n};\n"],"mappings":"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"}
+{"version":3,"file":"schema--xYWRGfe.mjs","names":["parseInternal","parseFieldInternal"],"sources":["../src/runtime/field-parse.ts","../src/configure/types/field.ts","../src/configure/services/tailordb/schema.ts"],"sourcesContent":["import type { FieldMetadata, TailorFieldType } from \"#/configure/types/field.types\";\nimport type { TailorPrincipal } from \"#/runtime/types\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\nconst regex = {\n  uuid: /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,\n  date: /^(?<year>\\d{4})-(?<month>\\d{2})-(?<day>\\d{2})$/,\n  time: /^(?<hour>[01]\\d|2[0-3]):(?<minute>[0-5]\\d)$/,\n  datetime:\n    /^(?<year>\\d{4})-(?<month>\\d{2})-(?<day>\\d{2})[Tt](?<hour>[01]\\d|2[0-3]):(?<minute>[0-5]\\d):(?<second>[0-5]\\d|60)(\\.(?<fraction>\\d+))?(?<offset>[Zz]|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$/,\n  decimal: /^-?(\\d+\\.?\\d*|\\.\\d+)([eE][+-]?\\d+)?$/,\n} as const;\n\nexport type FieldParseArgs = {\n  value: unknown;\n  data: unknown;\n  invoker: TailorPrincipal | null;\n};\n\nexport type FieldParseInternalArgs = {\n  value: unknown;\n  data: unknown;\n  invoker: TailorPrincipal | null;\n  pathArray: string[];\n};\n\nexport type FieldRuntime<T extends TailorFieldType = TailorFieldType> = {\n  readonly type: T;\n  readonly fields: Record<string, FieldRuntime>;\n  _metadata: FieldMetadata;\n};\n\ntype FieldParseRuntimeArgs<T extends TailorFieldType> = FieldParseInternalArgs & {\n  field: FieldRuntime<T>;\n};\n\ntype FieldValidationArgs<T extends TailorFieldType> = FieldParseRuntimeArgs<T> & {\n  issues: StandardSchemaV1.Issue[];\n};\n\nfunction validateBaseValue<T extends TailorFieldType>(args: FieldValidationArgs<T>): boolean {\n  const { field, value, pathArray, issues } = args;\n  const path = pathArray.length > 0 ? pathArray : undefined;\n  const initialIssueCount = issues.length;\n\n  switch (field.type) {\n    case \"string\":\n      if (typeof value !== \"string\") {\n        issues.push({\n          message: `Expected a string: received ${String(value)}`,\n          path,\n        });\n      }\n      break;\n\n    case \"integer\":\n      if (typeof value !== \"number\" || !Number.isInteger(value)) {\n        issues.push({\n          message: `Expected an integer: received ${String(value)}`,\n          path,\n        });\n      }\n      break;\n\n    case \"float\":\n      if (typeof value !== \"number\" || !Number.isFinite(value)) {\n        issues.push({\n          message: `Expected a number: received ${String(value)}`,\n          path,\n        });\n      }\n      break;\n\n    case \"boolean\":\n      if (typeof value !== \"boolean\") {\n        issues.push({\n          message: `Expected a boolean: received ${String(value)}`,\n          path,\n        });\n      }\n      break;\n\n    case \"uuid\":\n      if (typeof value !== \"string\" || !regex.uuid.test(value)) {\n        issues.push({\n          message: `Expected a valid UUID: received ${String(value)}`,\n          path,\n        });\n      }\n      break;\n    case \"date\":\n      if (typeof value !== \"string\" || !regex.date.test(value)) {\n        issues.push({\n          message: `Expected to match \"yyyy-MM-dd\" format: received ${String(value)}`,\n          path,\n        });\n      }\n      break;\n    case \"datetime\":\n      if (typeof value !== \"string\" || !regex.datetime.test(value)) {\n        issues.push({\n          message: `Expected to match ISO format: received ${String(value)}`,\n          path,\n        });\n      }\n      break;\n    case \"time\":\n      if (typeof value !== \"string\" || !regex.time.test(value)) {\n        issues.push({\n          message: `Expected to match \"HH:mm\" format: received ${String(value)}`,\n          path,\n        });\n      }\n      break;\n    case \"decimal\":\n      if (typeof value !== \"string\" || !regex.decimal.test(value)) {\n        issues.push({\n          message: `Expected a decimal string: received ${String(value)}`,\n          path,\n        });\n      }\n      break;\n\n    case \"enum\":\n      if (field._metadata.allowedValues) {\n        const allowedValues = field._metadata.allowedValues.map((v) => v.value);\n        if (typeof value !== \"string\" || !allowedValues.includes(value)) {\n          issues.push({\n            message: `Must be one of [${allowedValues.join(\", \")}]: received ${String(value)}`,\n            path,\n          });\n        }\n      }\n      break;\n\n    case \"nested\": {\n      // Runtime input may not match the declared field type.\n      // oxlint-disable typescript/no-unnecessary-condition\n      if (\n        typeof value !== \"object\" ||\n        value === null ||\n        Array.isArray(value) ||\n        value instanceof Date\n      ) {\n        // oxlint-enable typescript/no-unnecessary-condition\n        issues.push({\n          message: `Expected an object: received ${String(value)}`,\n          path,\n        });\n        return false;\n      }\n\n      let nestedBaseValid = true;\n      for (const [fieldName, nestedField] of Object.entries(field.fields)) {\n        const fieldValue = (value as Record<string, unknown>)[fieldName];\n        if (\n          !validateBaseField({\n            ...args,\n            field: nestedField,\n            value: fieldValue,\n            pathArray: pathArray.concat(fieldName),\n          })\n        ) {\n          nestedBaseValid = false;\n        }\n      }\n      return nestedBaseValid;\n    }\n  }\n\n  return issues.length === initialIssueCount;\n}\n\nfunction validateCustomValue<T extends TailorFieldType>(\n  args: FieldValidationArgs<T>,\n  validateFns: NonNullable<FieldMetadata[\"validate\"]>,\n): void {\n  const { value, pathArray, issues } = args;\n  const path = pathArray.length > 0 ? pathArray : undefined;\n\n  for (const fn of validateFns) {\n    const result = fn({ value });\n    if (typeof result === \"string\") {\n      issues.push({\n        message: result,\n        path,\n      });\n    }\n  }\n}\n\nfunction validateBaseField<T extends TailorFieldType>(args: FieldValidationArgs<T>): boolean {\n  const { field, value, pathArray, issues } = args;\n  const path = pathArray.length > 0 ? pathArray : undefined;\n\n  const isNullOrUndefined = value === null || value === undefined;\n  if (field._metadata.required && isNullOrUndefined) {\n    issues.push({\n      message: \"Required field is missing\",\n      path,\n    });\n    return false;\n  }\n\n  if (!field._metadata.required && isNullOrUndefined) {\n    return true;\n  }\n\n  let baseValid = true;\n  if (field._metadata.array) {\n    if (!Array.isArray(value)) {\n      issues.push({\n        message: \"Expected an array\",\n        path,\n      });\n      return false;\n    }\n\n    for (let i = 0; i < value.length; i++) {\n      if (\n        !validateBaseValue({\n          ...args,\n          value: value[i],\n          pathArray: pathArray.concat(`[${i}]`),\n        })\n      ) {\n        baseValid = false;\n      }\n    }\n  } else {\n    baseValid = validateBaseValue(args);\n  }\n\n  return baseValid;\n}\n\nfunction validateCustomField<T extends TailorFieldType>(args: FieldValidationArgs<T>): void {\n  const { field, value, pathArray } = args;\n  if (value === null || value === undefined) {\n    return;\n  }\n\n  if (field.type === \"nested\") {\n    const records = field._metadata.array\n      ? (value as Record<string, unknown>[])\n      : [value as Record<string, unknown>];\n\n    for (let i = 0; i < records.length; i++) {\n      const record = records[i] as Record<string, unknown>;\n      const recordPath = field._metadata.array ? pathArray.concat(`[${i}]`) : pathArray;\n      for (const [fieldName, nestedField] of Object.entries(field.fields)) {\n        validateCustomField({\n          ...args,\n          field: nestedField,\n          value: record[fieldName],\n          pathArray: recordPath.concat(fieldName),\n        });\n      }\n    }\n  }\n\n  const validateFns = field._metadata.validate;\n  if (validateFns?.length) {\n    validateCustomValue(args, validateFns);\n  }\n}\n\nexport function parseInternal<T extends TailorFieldType, Output>(\n  args: FieldParseRuntimeArgs<T>,\n): StandardSchemaV1.Result<Output> {\n  const { value } = args;\n  const issues: StandardSchemaV1.Issue[] = [];\n  const validationArgs = { ...args, issues };\n  const baseValid = validateBaseField(validationArgs);\n  if (baseValid) {\n    validateCustomField(validationArgs);\n  }\n  if (issues.length > 0) {\n    return { issues };\n  }\n\n  return { value: (value ?? null) as Output };\n}\n\ntype ParseInputFieldsArgs = FieldParseArgs & {\n  fields: Record<string, FieldRuntime>;\n};\n\n/**\n * Validate a value against a record of input fields, treating the record as a\n * single required object — the same code path deployed functions run via\n * `t.object(fields).parse(...)`, so local validation matches platform behavior.\n * @param args - Input field definitions plus the value, context data, and user\n * @returns Validation result\n */\nexport function parseInputFields(args: ParseInputFieldsArgs): StandardSchemaV1.Result<unknown> {\n  const { fields, ...parseArgs } = args;\n  return parseInternal({\n    ...parseArgs,\n    field: { type: \"nested\", fields, _metadata: { required: true } },\n    pathArray: [],\n  });\n}\n","import type { EnumValue } from \"#/configure/types/field.types\";\n\nexport type AllowedValues = readonly [string | EnumValue, ...(string | EnumValue)[]];\n\n/**\n * Normalize allowed values into EnumValue objects with descriptions.\n * @param values - Allowed values as strings or EnumValue objects\n * @returns Normalized allowed values\n */\nexport function mapAllowedValues(values: AllowedValues): EnumValue[] {\n  return values.map((value) => {\n    if (typeof value === \"string\") {\n      return { value, description: \"\" };\n    }\n    return { ...value, description: value.description ?? \"\" };\n  });\n}\n\nexport type AllowedValuesOutput<V extends AllowedValues> = V[number] extends infer T\n  ? T extends string\n    ? T\n    : T extends { value: infer K }\n      ? K\n      : never\n  : never;\n","import { cloneDeep } from \"es-toolkit\";\nimport {\n  type AllowedValues,\n  type AllowedValuesOutput,\n  mapAllowedValues,\n} from \"#/configure/types/field\";\nimport {\n  parseInternal as parseFieldInternal,\n  type FieldParseArgs,\n  type FieldParseInternalArgs,\n} from \"#/runtime/field-parse\";\nimport { brandValue } from \"#/utils/brand\";\nimport type {\n  TailorDBField as TailorDBFieldBase,\n  TailorDBType as TailorDBTypeBase,\n  DBFieldMetadata,\n  DefinedDBFieldMetadata,\n  SerialConfig,\n  IndexDef,\n  TailorDBTypeMetadata,\n  RawRelationConfig,\n  RelationType,\n} from \"#/configure/services/tailordb/types\";\nimport type {\n  FieldOptions,\n  FieldOutput,\n  TailorFieldType,\n  TailorToTs,\n  FieldValidateInput,\n} from \"#/configure/types/field.types\";\nimport type { PluginAttachment, PluginConfigs } from \"#/plugin/types\";\nimport type { InferredAttributes } from \"#/runtime/types\";\nimport type { output, InferFieldsOutput, TypeLevelError } from \"#/types/helpers\";\nimport type { RawPermissions } from \"#/types/tailordb.generated\";\nimport type { TailorTypeGqlPermission, TailorTypePermission } from \"./permission\";\nimport type {\n  Hook,\n  TypeHook,\n  ExcludeNestedDBFields,\n  ExcludeHookedDBFields,\n  ExcludeDefaultedDBFields,\n  TypeFeatures,\n  TypeValidateFn,\n} from \"./types\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\n// Erased DB fields stay assignable across builder method-state changes.\n// oxlint-disable-next-line no-explicit-any\ntype AnyBuilderMethod = any;\n\nexport type TailorAnyDBField = Omit<\n  TailorDBFieldBase<AnyBuilderMethod, AnyBuilderMethod>,\n  \"fields\"\n> & {\n  readonly fields: Record<string, AnyBuilderMethod>;\n  _metadata: DBFieldMetadata;\n  parse: AnyBuilderMethod;\n  readonly typeName: TypeLevelError<string>;\n  description: AnyBuilderMethod;\n  relation: AnyBuilderMethod;\n  index: AnyBuilderMethod;\n  unique: AnyBuilderMethod;\n  vector: AnyBuilderMethod;\n  default: AnyBuilderMethod;\n  hooks: AnyBuilderMethod;\n  validate: AnyBuilderMethod;\n  serial: AnyBuilderMethod;\n  clone: AnyBuilderMethod;\n};\n\n// Helper alias\n// oxlint-disable-next-line no-explicit-any\nexport type TailorAnyDBType = TailorDBType<any, any, any>;\n\ntype IsAny<T> = 0 extends 1 & T ? true : false;\ntype DBFieldTypeNameMethod<Defined extends DefinedDBFieldMetadata> =\n  IsAny<Defined> extends true\n    ? TypeLevelError<string>\n    : TypeLevelError<\"typeName cannot be used on TailorDB fields\">;\n\ntype WithDBFieldDescription<Defined> = Defined & { description: true };\ntype WithDBFieldRelation<Defined, S extends RelationType | RelationSelfConfig> = S extends\n  | \"oneToOne\"\n  | \"1-1\"\n  ? Defined & { unique: true; index: true; relation: true }\n  : S extends { type: \"oneToOne\" | \"1-1\" }\n    ? Defined & { unique: true; index: true; relation: true }\n    : Defined & { index: true; relation: true };\ntype WithDBFieldIndex<Defined> = Defined & { index: true };\ntype WithDBFieldUnique<Defined> = Defined & { unique: true; index: true };\ntype WithDBFieldVector<Defined> = Defined & { vector: true };\ntype WithDBFieldHooks<Defined, H> = Defined & {\n  hooks: {\n    create: H extends { create: unknown } ? true : false;\n    update: H extends { update: unknown } ? true : false;\n  };\n  serial: false;\n};\ntype WithDBFieldDefault<Defined> = Defined & { default: true };\ntype WithDBFieldValidate<Defined> = Defined & { validate: true };\ntype WithDBFieldSerial<Defined> = Defined & {\n  serial: true;\n  hooks: { create: false; update: false };\n};\ntype WithDBFieldCloneOptions<Defined extends DefinedDBFieldMetadata, NewOpt extends FieldOptions> =\n  IsAny<Defined> extends true\n    ? Defined\n    : Omit<Defined, \"array\"> & {\n        array: NewOpt extends { array: true }\n          ? true\n          : NewOpt extends { array: false }\n            ? false\n            : Defined[\"array\"];\n      };\ntype NonNullableDBFieldOutput<Output> = Exclude<Output, null>;\ntype DBFieldScalarOutput<Output> =\n  NonNullableDBFieldOutput<Output> extends (infer Item)[] ? Item : NonNullableDBFieldOutput<Output>;\ntype DBFieldCloneArrayOutput<Output, NewOpt extends FieldOptions> = NewOpt extends {\n  array: true;\n}\n  ? DBFieldScalarOutput<Output>[]\n  : NewOpt extends { array: false }\n    ? DBFieldScalarOutput<Output>\n    : NonNullableDBFieldOutput<Output>;\ntype DBFieldCloneOutput<Output, NewOpt extends FieldOptions> = NewOpt extends { optional: true }\n  ? DBFieldCloneArrayOutput<Output, NewOpt> | null\n  : NewOpt extends { optional: false }\n    ? DBFieldCloneArrayOutput<Output, NewOpt>\n    : null extends Output\n      ? DBFieldCloneArrayOutput<Output, NewOpt> | null\n      : DBFieldCloneArrayOutput<Output, NewOpt>;\ntype DBFieldCloneOptions<Defined extends DefinedDBFieldMetadata> = Omit<FieldOptions, \"array\"> & {\n  array?: Defined extends { validate: unknown } ? Defined[\"array\"] : boolean;\n};\ntype InvalidValidatedArrayCloneKeys<\n  Fields extends Record<string, TailorAnyDBField>,\n  K extends keyof Fields,\n  Opt extends FieldOptions,\n> = Opt extends { array: infer ArrayOption }\n  ? {\n      [P in K]: Fields[P] extends TailorDBField<infer Defined, infer _Output>\n        ? Defined extends { validate: unknown }\n          ? ArrayOption extends Defined[\"array\"]\n            ? never\n            : P\n          : never\n        : never;\n    }[K]\n  : never;\ntype DBFieldsCloneOptionsGuard<\n  Fields extends Record<string, TailorAnyDBField>,\n  K extends keyof Fields,\n  Opt extends FieldOptions,\n> = [InvalidValidatedArrayCloneKeys<Fields, K, Opt>] extends [never]\n  ? unknown\n  : TypeLevelError<\"array cannot be changed on fields with custom validation\">;\ntype DefinedDBTypeMetadata = {\n  hooks?: true;\n  validate?: true;\n  features?: true;\n  indexes?: true;\n  files?: true;\n  permission?: true;\n  gqlPermission?: true;\n  description?: true;\n};\ntype WithDBTypeMetadata<\n  Defined extends DefinedDBTypeMetadata,\n  Key extends keyof DefinedDBTypeMetadata,\n> = Defined & Record<Key, true>;\ntype DBTypeDuplicateInputGuard<\n  Defined extends DefinedDBTypeMetadata,\n  Key extends keyof DefinedDBTypeMetadata,\n  Input,\n  Message extends string,\n> =\n  IsAny<Defined> extends true\n    ? Input\n    : Defined extends Record<Key, unknown>\n      ? TypeLevelError<Message>\n      : Input;\ntype DBTypeDuplicateRestGuard<\n  Defined extends DefinedDBTypeMetadata,\n  Key extends keyof DefinedDBTypeMetadata,\n  Input extends unknown[],\n  Message extends string,\n> =\n  IsAny<Defined> extends true\n    ? Input\n    : Defined extends Record<Key, unknown>\n      ? [TypeLevelError<Message>, ...TypeLevelError<Message>[]]\n      : Input;\ntype FileKeyConflictError<\n  Fields extends Record<string, TailorAnyDBField>,\n  User extends object,\n> = Partial<\n  Record<\n    keyof output<TailorDBType<Fields, User>> & string,\n    TypeLevelError<\"file keys cannot use existing field names\">\n  >\n>;\ntype DBFieldDescriptionFn<\n  Defined extends DefinedDBFieldMetadata,\n  Output,\n  Nested extends Record<string, TailorAnyDBField>,\n> = (description: string) => TailorDBField<WithDBFieldDescription<Defined>, Output, Nested>;\ntype DBFieldRelationFn<\n  Defined extends DefinedDBFieldMetadata,\n  Output,\n  Nested extends Record<string, TailorAnyDBField>,\n> = {\n  <S extends RelationType, T extends TailorAnyDBType>(\n    config: RelationConfig<S, T>,\n  ): TailorDBField<WithDBFieldRelation<Defined, S>, Output, Nested>;\n  <S extends RelationSelfConfig>(\n    config: S,\n  ): TailorDBField<WithDBFieldRelation<Defined, S>, Output, Nested>;\n};\ntype DBFieldIndexFn<\n  Defined extends DefinedDBFieldMetadata,\n  Output,\n  Nested extends Record<string, TailorAnyDBField>,\n> = () => TailorDBField<WithDBFieldIndex<Defined>, Output, Nested>;\ntype DBFieldUniqueFn<\n  Defined extends DefinedDBFieldMetadata,\n  Output,\n  Nested extends Record<string, TailorAnyDBField>,\n> = () => TailorDBField<WithDBFieldUnique<Defined>, Output, Nested>;\ntype DBFieldVectorFn<\n  Defined extends DefinedDBFieldMetadata,\n  Output,\n  Nested extends Record<string, TailorAnyDBField>,\n> = () => TailorDBField<WithDBFieldVector<Defined>, Output, Nested>;\ntype DBFieldHooksFn<\n  Defined extends DefinedDBFieldMetadata,\n  Output,\n  Nested extends Record<string, TailorAnyDBField>,\n> = <\n  const H extends Hook<\n    Output,\n    Defined extends { default: true } ? Output | null | undefined : Output\n  >,\n>(\n  hooks: H,\n) => TailorDBField<WithDBFieldHooks<Defined, H>, Output, Nested>;\ntype DBFieldValidateFn<\n  Defined extends DefinedDBFieldMetadata,\n  Output,\n  Nested extends Record<string, TailorAnyDBField>,\n> = (\n  ...validate: FieldValidateInput<Output>[]\n) => TailorDBField<WithDBFieldValidate<Defined>, Output, Nested>;\ntype DBFieldSerialFn<\n  Defined extends DefinedDBFieldMetadata,\n  Output,\n  Nested extends Record<string, TailorAnyDBField>,\n> = (\n  config: SerialConfig<Defined[\"type\"] & (\"integer\" | \"string\")>,\n) => TailorDBField<WithDBFieldSerial<Defined>, Output, Nested>;\ntype DBFieldDescriptionMethod<\n  Defined extends DefinedDBFieldMetadata,\n  Output,\n  Nested extends Record<string, TailorAnyDBField>,\n> =\n  IsAny<Defined> extends true\n    ? DBFieldDescriptionFn<Defined, Output, Nested>\n    : Defined extends { description: unknown }\n      ? TypeLevelError<\".description() has already been set\">\n      : DBFieldDescriptionFn<Defined, Output, Nested>;\ntype DBFieldRelationMethod<\n  Defined extends DefinedDBFieldMetadata,\n  Output,\n  Nested extends Record<string, TailorAnyDBField>,\n> =\n  IsAny<Defined> extends true\n    ? DBFieldRelationFn<Defined, Output, Nested>\n    : Defined extends { relation: unknown }\n      ? TypeLevelError<\".relation() has already been set\">\n      : DBFieldRelationFn<Defined, Output, Nested>;\ntype DBFieldArrayCheck<A extends boolean, Ok, Msg extends string> = A extends true\n  ? TypeLevelError<Msg>\n  : Ok;\ntype DBFieldIndexMethod<\n  Defined extends DefinedDBFieldMetadata,\n  Output,\n  Nested extends Record<string, TailorAnyDBField>,\n> =\n  IsAny<Defined> extends true\n    ? DBFieldIndexFn<Defined, Output, Nested>\n    : Defined extends { index: unknown }\n      ? TypeLevelError<\".index() has already been set\">\n      : DBFieldArrayCheck<\n          Defined[\"array\"],\n          DBFieldIndexFn<Defined, Output, Nested>,\n          \"index cannot be set on array fields\"\n        >;\ntype DBFieldUniqueMethod<\n  Defined extends DefinedDBFieldMetadata,\n  Output,\n  Nested extends Record<string, TailorAnyDBField>,\n> =\n  IsAny<Defined> extends true\n    ? DBFieldUniqueFn<Defined, Output, Nested>\n    : Defined extends { unique: unknown }\n      ? TypeLevelError<\".unique() has already been set\">\n      : DBFieldArrayCheck<\n          Defined[\"array\"],\n          DBFieldUniqueFn<Defined, Output, Nested>,\n          \"unique cannot be set on array fields\"\n        >;\ntype DBFieldVectorMethod<\n  Defined extends DefinedDBFieldMetadata,\n  Output,\n  Nested extends Record<string, TailorAnyDBField>,\n> =\n  IsAny<Defined> extends true\n    ? DBFieldVectorFn<Defined, Output, Nested>\n    : Defined extends { vector: unknown }\n      ? TypeLevelError<\".vector() has already been set\">\n      : Defined extends { type: \"string\"; array: false }\n        ? DBFieldVectorFn<Defined, Output, Nested>\n        : TypeLevelError<\"vector can only be set on non-array string fields\">;\ntype DBFieldHooksMethod<\n  Defined extends DefinedDBFieldMetadata,\n  Output,\n  Nested extends Record<string, TailorAnyDBField>,\n> =\n  IsAny<Defined> extends true\n    ? DBFieldHooksFn<Defined, Output, Nested>\n    : Defined extends {\n          serial: true;\n          hooks: { create: false; update: false };\n        }\n      ? TypeLevelError<\"hooks cannot be set after serial\">\n      : Defined extends {\n            hooks: unknown;\n          }\n        ? TypeLevelError<\".hooks() has already been set\">\n        : Defined extends { type: \"nested\" }\n          ? TypeLevelError<\"hooks cannot be set on nested type fields\">\n          : DBFieldHooksFn<Defined, Output, Nested>;\ntype DBFieldValidateMethod<\n  Defined extends DefinedDBFieldMetadata,\n  Output,\n  Nested extends Record<string, TailorAnyDBField>,\n> =\n  IsAny<Defined> extends true\n    ? DBFieldValidateFn<Defined, Output, Nested>\n    : Defined extends { validate: unknown }\n      ? TypeLevelError<\".validate() has already been set\">\n      : DBFieldValidateFn<Defined, Output, Nested>;\ntype DBFieldSerialMethod<\n  Defined extends DefinedDBFieldMetadata,\n  Output,\n  Nested extends Record<string, TailorAnyDBField>,\n> =\n  IsAny<Defined> extends true\n    ? DBFieldSerialFn<Defined, Output, Nested>\n    : Defined extends { serial: true }\n      ? TypeLevelError<\".serial() has already been set\">\n      : Defined extends { serial: false }\n        ? TypeLevelError<\"serial cannot be set after hooks\">\n        : IsAny<Output> extends true\n          ? Defined extends { type: \"integer\" | \"string\"; array: false }\n            ? DBFieldSerialFn<Defined, Output, Nested>\n            : TypeLevelError<\"serial can only be set on non-array integer or string fields\">\n          : null extends Output\n            ? TypeLevelError<\"serial can only be set on non-array integer or string fields\">\n            : Defined extends { type: \"integer\" | \"string\"; array: false }\n              ? DBFieldSerialFn<Defined, Output, Nested>\n              : TypeLevelError<\"serial can only be set on non-array integer or string fields\">;\ntype DBFieldDefaultFn<\n  Defined extends DefinedDBFieldMetadata,\n  Output,\n  Nested extends Record<string, TailorAnyDBField>,\n> = (\n  value: Output extends null ? NonNullable<Output> : Output,\n) => TailorDBField<WithDBFieldDefault<Defined>, Output, Nested>;\ntype DBFieldDefaultMethod<\n  Defined extends DefinedDBFieldMetadata,\n  Output,\n  Nested extends Record<string, TailorAnyDBField>,\n> =\n  IsAny<Defined> extends true\n    ? DBFieldDefaultFn<Defined, Output, Nested>\n    : Defined extends { default: unknown }\n      ? TypeLevelError<\".default() has already been set\">\n      : Defined extends { type: \"nested\" }\n        ? TypeLevelError<\"default cannot be set on nested type fields\">\n        : Defined extends { serial: true }\n          ? TypeLevelError<\"default cannot be set on serial fields\">\n          : null extends Output\n            ? TypeLevelError<\"default cannot be set on optional fields\">\n            : DBFieldDefaultFn<Defined, Output, Nested>;\n\n/**\n * Full TailorDBField interface with builder methods.\n * Extends the minimal structural interface from types/ with fluent API methods.\n */\nexport interface TailorDBField<\n  Defined extends DefinedDBFieldMetadata = DefinedDBFieldMetadata,\n  // oxlint-disable-next-line no-explicit-any\n  Output = any,\n  // Nested object fields, so a `db.object()` field keeps the shape it was declared with.\n  // Every builder method passes it through; dropping it here would erase the shape as\n  // soon as one is chained.\n  Nested extends Record<string, TailorAnyDBField> = Record<string, TailorAnyDBField>,\n> extends Omit<TailorDBFieldBase<Defined, Output, Nested>, \"fields\"> {\n  readonly fields: Nested;\n  _metadata: DBFieldMetadata;\n\n  /**\n   * Parse and validate a value against this field's validation rules\n   */\n  parse(args: FieldParseArgs): StandardSchemaV1.Result<Output>;\n\n  /**\n   * typeName is not available on TailorDB fields.\n   * Use typeName on pipeline fields (t.enum / t.object) instead.\n   */\n  typeName: DBFieldTypeNameMethod<Defined>;\n\n  /**\n   * Set a description for the field\n   */\n  description: DBFieldDescriptionMethod<Defined, Output, Nested>;\n\n  /**\n   * Define a relation to another type.\n   */\n  relation: DBFieldRelationMethod<Defined, Output, Nested>;\n\n  /**\n   * Add an index to the field\n   */\n  index: DBFieldIndexMethod<Defined, Output, Nested>;\n\n  /**\n   * Make the field unique (also adds an index)\n   */\n  unique: DBFieldUniqueMethod<Defined, Output, Nested>;\n\n  /**\n   * Enable vector search on the field (string type only)\n   */\n  vector: DBFieldVectorMethod<Defined, Output, Nested>;\n\n  /**\n   * Set a default value for the field on create. When the field is required,\n   * this makes it optional in the Create input — the default fills in when\n   * no value (or a nullish hook result) is provided.\n   *\n   * For datetime/date/time fields, pass `\"now\"` to use the operation timestamp.\n   */\n  default: DBFieldDefaultMethod<Defined, Output, Nested>;\n\n  /**\n   * Add hooks for create/update operations on this field.\n   */\n  hooks: DBFieldHooksMethod<Defined, Output, Nested>;\n\n  /**\n   * Add validation functions to the field.\n   *\n   * Validators receive `{ value, data, user }` and run after hooks and\n   * built-in type validation; they are skipped when built-in validation\n   * fails. For array fields, `value` is the complete array.\n   */\n  validate: DBFieldValidateMethod<Defined, Output, Nested>;\n\n  /**\n   * Configure serial/auto-increment behavior\n   */\n  serial: DBFieldSerialMethod<Defined, Output, Nested>;\n\n  /**\n   * Clone the field with optional overrides for field options.\n   * The `array` option cannot change on fields with custom validation.\n   */\n  clone<const NewOpt extends DBFieldCloneOptions<Defined>>(\n    options?: NewOpt,\n  ): TailorDBField<\n    WithDBFieldCloneOptions<Defined, NewOpt>,\n    DBFieldCloneOutput<Output, NewOpt>,\n    Nested\n  >;\n}\n\n/**\n * Full TailorDBType interface with builder methods.\n * Extends the minimal structural interface from types/ with fluent API methods.\n */\nexport interface TailorDBType<\n  // oxlint-disable-next-line no-explicit-any\n  Fields extends Record<string, TailorAnyDBField> = any,\n  User extends object = InferredAttributes,\n  // oxlint-disable-next-line no-explicit-any\n  Defined extends DefinedDBTypeMetadata = any,\n> extends TailorDBTypeBase<Fields, User> {\n  _description?: string;\n\n  hooks(\n    hook: DBTypeDuplicateInputGuard<\n      Defined,\n      \"hooks\",\n      TypeHook<Fields>,\n      \".hooks() has already been set\"\n    >,\n  ): TailorDBType<Fields, User, WithDBTypeMetadata<Defined, \"hooks\">>;\n  validate(\n    fn: DBTypeDuplicateInputGuard<\n      Defined,\n      \"validate\",\n      TypeValidateFn<Fields>,\n      \".validate() has already been set\"\n    >,\n  ): TailorDBType<Fields, User, WithDBTypeMetadata<Defined, \"validate\">>;\n  features(\n    features: DBTypeDuplicateInputGuard<\n      Defined,\n      \"features\",\n      Omit<TypeFeatures, \"pluralForm\">,\n      \".features() has already been set\"\n    >,\n  ): TailorDBType<Fields, User, WithDBTypeMetadata<Defined, \"features\">>;\n  indexes(\n    ...indexes: DBTypeDuplicateRestGuard<\n      Defined,\n      \"indexes\",\n      IndexDef<TailorDBType<Fields, User, Defined>>[],\n      \".indexes() has already been set\"\n    >\n  ): TailorDBType<Fields, User, WithDBTypeMetadata<Defined, \"indexes\">>;\n  files<const F extends string>(\n    files: DBTypeDuplicateInputGuard<\n      Defined,\n      \"files\",\n      Record<F, string> & FileKeyConflictError<Fields, User>,\n      \".files() has already been set\"\n    >,\n  ): TailorDBType<Fields, User, WithDBTypeMetadata<Defined, \"files\">>;\n  permission<\n    U extends object = User,\n    P extends TailorTypePermission<U, output<TailorDBType<Fields, User, Defined>>> =\n      TailorTypePermission<U, output<TailorDBType<Fields, User, Defined>>>,\n  >(\n    permission: DBTypeDuplicateInputGuard<\n      Defined,\n      \"permission\",\n      P,\n      \".permission() has already been set\"\n    >,\n  ): TailorDBType<Fields, U, WithDBTypeMetadata<Defined, \"permission\">>;\n  gqlPermission<\n    U extends object = User,\n    P extends TailorTypeGqlPermission<U> = TailorTypeGqlPermission<U>,\n  >(\n    permission: DBTypeDuplicateInputGuard<\n      Defined,\n      \"gqlPermission\",\n      P,\n      \".gqlPermission() has already been set\"\n    >,\n  ): TailorDBType<Fields, U, WithDBTypeMetadata<Defined, \"gqlPermission\">>;\n  description(\n    description: DBTypeDuplicateInputGuard<\n      Defined,\n      \"description\",\n      string,\n      \".description() has already been set\"\n    >,\n  ): TailorDBType<Fields, User, WithDBTypeMetadata<Defined, \"description\">>;\n  pickFields<K extends keyof Fields>(keys: K[]): Pick<Fields, K>;\n  pickFields<K extends keyof Fields, const Opt extends FieldOptions>(\n    keys: K[],\n    options: Opt & DBFieldsCloneOptionsGuard<Fields, K, Opt>,\n  ): {\n    [P in K]: Fields[P] extends TailorDBField<infer D, infer O>\n      ? TailorDBField<WithDBFieldCloneOptions<D, Opt>, DBFieldCloneOutput<O, Opt>>\n      : never;\n  };\n  omitFields<K extends keyof Fields>(keys: K[]): Omit<Fields, K>;\n  plugin<P extends keyof PluginConfigs<keyof Fields & string>>(config: {\n    [K in P]: PluginConfigs<keyof Fields & string>[K];\n  }): TailorDBType<Fields, User, Defined>;\n}\n\nexport type TailorDBInstance<\n  // oxlint-disable-next-line no-explicit-any\n  Fields extends Record<string, TailorAnyDBField> = any,\n  User extends object = InferredAttributes,\n  // oxlint-disable-next-line no-explicit-any\n  Defined extends DefinedDBTypeMetadata = any,\n> = TailorDBType<Fields, User, Defined>;\n\ninterface RelationConfig<S extends RelationType, T extends TailorDBType> {\n  type: S;\n  toward: {\n    type: T;\n    as?: string;\n    key?: keyof T[\"fields\"] & string;\n  };\n  backward?: string;\n}\n\n// Special config variant for self-referencing relations\ntype RelationSelfConfig = {\n  type: RelationType;\n  toward: {\n    type: \"self\";\n    as?: string;\n    key?: string;\n  };\n  backward?: string;\n};\n\nfunction isRelationSelfConfig(\n  config: RelationConfig<RelationType, TailorDBType> | RelationSelfConfig,\n): config is RelationSelfConfig {\n  return config.toward.type === \"self\";\n}\n\ntype DBFieldDefined<T extends TailorFieldType, Opt extends FieldOptions> = {\n  type: T;\n  array: Opt extends { array: true } ? true : false;\n};\ntype DBFieldOutput<\n  T extends TailorFieldType,\n  Opt extends FieldOptions,\n  OutputBase = TailorToTs[T],\n> = FieldOutput<OutputBase, Opt>;\ntype TailorDBFieldInstance<\n  T extends TailorFieldType,\n  Opt extends FieldOptions,\n  OutputBase = TailorToTs[T],\n> = TailorDBField<DBFieldDefined<T, Opt>, DBFieldOutput<T, Opt, OutputBase>>;\ntype TailorDBFieldRuntimeInstance<\n  T extends TailorFieldType,\n  Opt extends FieldOptions,\n  OutputBase = TailorToTs[T],\n> = TailorDBFieldRuntime<DBFieldDefined<T, Opt>, DBFieldOutput<T, Opt, OutputBase>>;\ntype TailorDBFieldRuntime<Defined extends DefinedDBFieldMetadata, Output> = Omit<\n  TailorDBFieldBase<Defined, Output>,\n  \"fields\"\n> & {\n  readonly fields: Record<string, TailorAnyDBField>;\n  _metadata: DBFieldMetadata;\n  description(description: string): object;\n  typeName(typeName: string): object;\n  validate(...validate: FieldValidateInput<Output>[]): object;\n  relation(config: RelationConfig<RelationType, TailorDBType> | RelationSelfConfig): object;\n  index(): object;\n  unique(): object;\n  vector(): object;\n  default(value: unknown): object;\n  hooks(hooks: Hook<Output>): object;\n  serial(config: SerialConfig): object;\n  clone(options?: FieldOptions): TailorDBFieldRuntime<DefinedDBFieldMetadata, AnyBuilderMethod>;\n  parse(args: FieldParseArgs): StandardSchemaV1.Result<Output>;\n  _setRawRelation(relation: RawRelationConfig): void;\n};\n\n/**\n * Creates a new TailorDBField instance.\n * @param type - Field type\n * @param options - Field options\n * @param fields - Nested fields for object-like types\n * @param values - Allowed values for enum-like fields\n * @returns A new TailorDBField\n */\nfunction createTailorDBField<\n  const T extends TailorFieldType,\n  const TOptions extends FieldOptions,\n  const OutputBase = TailorToTs[T],\n>(\n  type: T,\n  options?: TOptions,\n  fields?: Record<string, TailorAnyDBField>,\n  values?: AllowedValues,\n): TailorDBFieldInstance<T, TOptions, OutputBase>;\nfunction createTailorDBField<const T extends TailorFieldType, const TOptions extends FieldOptions>(\n  type: T,\n  options?: TOptions,\n  fields?: Record<string, TailorAnyDBField>,\n  values?: AllowedValues,\n): object {\n  return createTailorDBFieldRuntime(type, options, fields, values);\n}\n\nfunction createTailorDBFieldRuntime<\n  const T extends TailorFieldType,\n  const TOptions extends FieldOptions,\n  const OutputBase = TailorToTs[T],\n>(\n  type: T,\n  options?: TOptions,\n  fields?: Record<string, TailorAnyDBField>,\n  values?: AllowedValues,\n): TailorDBFieldRuntimeInstance<T, TOptions, OutputBase> {\n  type FieldValue = DBFieldOutput<T, TOptions, OutputBase>;\n  type FieldType = TailorDBFieldRuntimeInstance<T, TOptions, OutputBase>;\n\n  const _metadata: DBFieldMetadata = { required: true };\n  let _rawRelation: RawRelationConfig | undefined;\n\n  if (options) {\n    if (options.optional === true) {\n      _metadata.required = false;\n    }\n    if (options.array === true) {\n      _metadata.array = true;\n    }\n  }\n  if (values) {\n    _metadata.allowedValues = mapAllowedValues(values);\n  }\n\n  function parseInternal(args: FieldParseInternalArgs): StandardSchemaV1.Result<FieldValue> {\n    return parseFieldInternal<T, FieldValue>({\n      ...args,\n      field,\n    });\n  }\n\n  function cloneWith(metadataUpdates: Partial<DBFieldMetadata>) {\n    const cloned = field.clone();\n    Object.assign(cloned._metadata, metadataUpdates);\n    return cloned;\n  }\n\n  const field: FieldType = {\n    type,\n    fields: fields ?? {},\n    _defined: undefined as unknown as DBFieldDefined<T, TOptions>,\n    _output: undefined as FieldValue,\n    _metadata,\n\n    get metadata() {\n      return { ...this._metadata };\n    },\n\n    get rawRelation(): Readonly<RawRelationConfig> | undefined {\n      return _rawRelation ? { ..._rawRelation, toward: { ..._rawRelation.toward } } : undefined;\n    },\n\n    description(description: string) {\n      return cloneWith({ description });\n    },\n\n    typeName(typeName: string) {\n      return cloneWith({ typeName });\n    },\n\n    validate(...validateInputs: FieldValidateInput<FieldValue>[]) {\n      return cloneWith({ validate: validateInputs });\n    },\n\n    parse(args: FieldParseArgs): StandardSchemaV1.Result<FieldValue> {\n      return parseInternal({\n        value: args.value,\n        data: args.data,\n        invoker: args.invoker,\n        pathArray: [],\n      });\n    },\n\n    // TailorDBField specific methods\n    relation(config: RelationConfig<RelationType, TailorDBType> | RelationSelfConfig) {\n      const cloned = field.clone();\n      const targetType = isRelationSelfConfig(config) ? \"self\" : config.toward.type.name;\n      cloned._setRawRelation({\n        type: config.type,\n        toward: {\n          type: targetType,\n          as: config.toward.as,\n          key: config.toward.key,\n        },\n        backward: config.backward,\n      });\n      return cloned;\n    },\n\n    index() {\n      return cloneWith({ index: true });\n    },\n\n    unique() {\n      return cloneWith({ unique: true, index: true });\n    },\n\n    vector() {\n      return cloneWith({ vector: true });\n    },\n\n    // oxlint-disable-next-line no-explicit-any\n    default(value: any) {\n      // oxlint-disable-next-line no-explicit-any\n      return cloneWith({ default: value }) as any;\n    },\n\n    hooks(hooks: Hook<FieldValue>) {\n      return cloneWith({ hooks });\n    },\n\n    serial(config: SerialConfig) {\n      return cloneWith({ serial: config });\n    },\n\n    clone(cloneOptions?: FieldOptions) {\n      if (\n        this._metadata.validate?.length &&\n        cloneOptions?.array !== undefined &&\n        cloneOptions.array !== (this._metadata.array === true)\n      ) {\n        throw new Error(\"Cannot change the array option on a field with custom validation\");\n      }\n\n      // Deep clone nested object fields if present\n      let clonedFields = fields;\n      if (fields) {\n        const cloned: Record<string, TailorAnyDBField> = {};\n        for (const [key, field] of Object.entries(fields)) {\n          cloned[key] = field.clone();\n        }\n        clonedFields = cloned;\n      }\n\n      // Create a new field with cloned configuration\n      const clonedField = createTailorDBFieldRuntime(type, options, clonedFields, values);\n\n      // Deep copy metadata using cloneDeep (preserves function references)\n      Object.assign(clonedField._metadata, cloneDeep(this._metadata));\n\n      // Apply new options if provided\n      if (cloneOptions) {\n        if (cloneOptions.optional !== undefined) {\n          clonedField._metadata.required = !cloneOptions.optional;\n        }\n        if (cloneOptions.array !== undefined) {\n          clonedField._metadata.array = cloneOptions.array;\n        }\n      }\n\n      // Copy raw relation if exists\n      if (_rawRelation) {\n        clonedField._setRawRelation(cloneDeep(_rawRelation));\n      }\n\n      return clonedField;\n    },\n\n    _setRawRelation(relation: RawRelationConfig) {\n      _rawRelation = relation;\n    },\n  };\n\n  return field;\n}\n\nconst createField = createTailorDBField;\n\n/**\n * Create a UUID field.\n * @param options - Field configuration options\n * @returns A UUID field\n * @example db.uuid()\n * @example db.uuid({ optional: true })\n */\nfunction uuid<const Opt extends FieldOptions>(options?: Opt) {\n  return createField(\"uuid\", options);\n}\n\n/**\n * Create a string field.\n * @param options - Field configuration options\n * @returns A string field\n * @example db.string()\n * @example db.string({ optional: true })\n */\nfunction string<const Opt extends FieldOptions>(options?: Opt) {\n  return createField(\"string\", options);\n}\n\n/**\n * Create a boolean field.\n * Note: The method name is `bool` but creates a `boolean` type field.\n * @param options - Field configuration options\n * @returns A boolean field\n * @example db.bool()\n * @example db.bool({ optional: true })\n */\nfunction bool<const Opt extends FieldOptions>(options?: Opt) {\n  return createField(\"boolean\", options);\n}\n\n/**\n * Create an integer field.\n * @param options - Field configuration options\n * @returns An integer field\n * @example db.int()\n * @example db.int({ optional: true })\n */\nfunction int<const Opt extends FieldOptions>(options?: Opt) {\n  return createField(\"integer\", options);\n}\n\n/**\n * Create a float (decimal number) field.\n * @param options - Field configuration options\n * @returns A float field\n * @example db.float()\n * @example db.float({ optional: true })\n */\nfunction float<const Opt extends FieldOptions>(options?: Opt) {\n  return createField(\"float\", options);\n}\n\ninterface DecimalFieldOptions extends FieldOptions {\n  scale?: number;\n}\n\n/**\n * Create a decimal field (stored as string for precision).\n * @param options - Field configuration options including optional scale (0-12)\n * @returns A decimal field\n * @example db.decimal()\n * @example db.decimal({ scale: 2 })\n * @example db.decimal({ scale: 2, optional: true })\n */\nfunction decimal<const Opt extends DecimalFieldOptions>(options?: Opt) {\n  if (options?.scale !== undefined) {\n    if (!Number.isInteger(options.scale) || options.scale < 0 || options.scale > 12) {\n      throw new Error(\"scale must be an integer between 0 and 12\");\n    }\n  }\n  const field = createField(\"decimal\", options);\n  if (options?.scale !== undefined) {\n    field._metadata.scale = options.scale;\n  }\n  return field;\n}\n\n/**\n * Create a date field (date only, no time component).\n * Format: \"yyyy-MM-dd\"\n * @param options - Field configuration options\n * @returns A date field\n * @example db.date()\n */\nfunction date<const Opt extends FieldOptions>(options?: Opt) {\n  return createField(\"date\", options);\n}\n\n/**\n * Create a datetime field (date and time).\n * Format: ISO 8601, such as \"yyyy-MM-ddTHH:mm:ssZ\" or \"yyyy-MM-ddTHH:mm:ss+09:00\"\n * @param options - Field configuration options\n * @returns A datetime field\n * @example db.datetime()\n */\nfunction datetime<const Opt extends FieldOptions>(options?: Opt) {\n  return createField(\"datetime\", options);\n}\n\n/**\n * Create a time field (time only, no date component).\n * Format: \"HH:mm\"\n * @param options - Field configuration options\n * @returns A time field\n * @example db.time()\n */\nfunction time<const Opt extends FieldOptions>(options?: Opt) {\n  return createField(\"time\", options);\n}\n\n/**\n * Create an enum field with a fixed set of allowed string values.\n * @param values - Array of allowed string values, or array of `{ value, description }` objects\n * @param options - Field configuration options\n * @returns An enum field\n * @example db.enum([\"active\", \"inactive\", \"suspended\"])\n * @example db.enum([\"small\", \"medium\", \"large\"], { optional: true })\n */\nfunction _enum<const V extends AllowedValues, const Opt extends FieldOptions>(\n  values: V,\n  options?: Opt,\n): TailorDBField<\n  { type: \"enum\"; array: Opt extends { array: true } ? true : false },\n  FieldOutput<AllowedValuesOutput<V>, Opt>\n> {\n  return createField<\"enum\", Opt, AllowedValuesOutput<V>>(\"enum\", options, undefined, values);\n}\n\n/**\n * Create a nested object field with sub-fields.\n * @param fields - Record of nested field definitions\n * @param options - Field configuration options\n * @returns A nested object field\n * @example db.object({ street: db.string(), city: db.string(), zip: db.string() })\n * @example db.object({ name: db.string() }, { optional: true })\n */\nfunction object<\n  const F extends Record<string, TailorAnyDBField> &\n    ExcludeNestedDBFields<F> &\n    ExcludeHookedDBFields<F> &\n    ExcludeDefaultedDBFields<F>,\n  const Opt extends FieldOptions,\n>(fields: F, options?: Opt) {\n  return createField(\"nested\", options, fields) as unknown as TailorDBField<\n    { type: \"nested\"; array: Opt extends { array: true } ? true : false },\n    FieldOutput<InferFieldsOutput<F>, Opt>,\n    F\n  >;\n}\n\n/**\n * Creates a new TailorDBType instance.\n * @param name - Type name\n * @param fields - Field definitions\n * @param options - Type options\n * @param options.pluralForm - Optional plural form\n * @param options.description - Optional description\n * @returns A new TailorDBType\n */\nfunction createTailorDBType<\n  // oxlint-disable-next-line no-explicit-any\n  const Fields extends Record<string, TailorAnyDBField> = any,\n  User extends object = InferredAttributes,\n>(\n  name: string,\n  fields: Fields,\n  options: { pluralForm?: string; description?: string },\n): TailorDBType<Fields, User, DefinedDBTypeMetadata> {\n  let _description = options.description;\n  let _settings: TypeFeatures = {};\n  let _indexes: IndexDef<TailorDBType<Fields, User, DefinedDBTypeMetadata>>[] = [];\n  const _permissions: RawPermissions = {};\n  let _files: Record<string, string> = {};\n  const _plugins: PluginAttachment[] = [];\n  // oxlint-disable-next-line typescript/no-unsafe-function-type\n  let _typeHook: { create?: Function; update?: Function } | undefined;\n  // oxlint-disable-next-line typescript/no-unsafe-function-type\n  let _typeValidate: Function | undefined;\n  const _definedMethods = new Set<keyof DefinedDBTypeMetadata>();\n  if (options.description !== undefined) {\n    _definedMethods.add(\"description\");\n  }\n\n  function runMethodOnce<T>(method: keyof DefinedDBTypeMetadata, action: () => T): T {\n    if (_definedMethods.has(method)) {\n      throw new Error(`.${method}() has already been set`);\n    }\n    const result = action();\n    _definedMethods.add(method);\n    return result;\n  }\n  type TypeAfter<Key extends keyof DefinedDBTypeMetadata> = TailorDBType<\n    Fields,\n    User,\n    WithDBTypeMetadata<DefinedDBTypeMetadata, Key>\n  >;\n  type TypeAfterUser<\n    NextUser extends object,\n    Key extends keyof DefinedDBTypeMetadata,\n  > = TailorDBType<Fields, NextUser, WithDBTypeMetadata<DefinedDBTypeMetadata, Key>>;\n\n  if (options.pluralForm) {\n    if (name === options.pluralForm) {\n      throw new Error(`The name and the plural form must be different. name=${name}`);\n    }\n    _settings.pluralForm = options.pluralForm;\n  }\n\n  const dbType: TailorDBType<Fields, User, DefinedDBTypeMetadata> = {\n    name,\n    fields: { ...fields },\n    _output: null as unknown as InferFieldsOutput<Fields>,\n    _description,\n\n    get metadata(): TailorDBTypeMetadata {\n      // Convert indexes to the format expected by the manifest\n      const indexes: Record<string, { fields: string[]; unique?: boolean }> = {};\n      if (_indexes.length > 0) {\n        _indexes.forEach((index) => {\n          const fieldNames = index.fields.map((field) => String(field));\n          const key = index.name || `idx_${fieldNames.join(\"_\")}`;\n          indexes[key] = {\n            fields: fieldNames,\n            unique: index.unique,\n          };\n        });\n      }\n\n      return {\n        name: this.name,\n        description: _description,\n        settings: _settings,\n        permissions: _permissions,\n        files: _files,\n        ...(Object.keys(indexes).length > 0 && { indexes }),\n        ...(_typeHook && { typeHook: _typeHook }),\n        ...(_typeValidate && { typeValidate: _typeValidate }),\n      };\n    },\n\n    hooks(hook: TypeHook<Fields>): TypeAfter<\"hooks\"> {\n      return runMethodOnce(\"hooks\", () => {\n        _typeHook = hook;\n        return this as TypeAfter<\"hooks\">;\n      });\n    },\n\n    validate(fn: TypeValidateFn<Fields>): TypeAfter<\"validate\"> {\n      return runMethodOnce(\"validate\", () => {\n        _typeValidate = fn;\n        return this as TypeAfter<\"validate\">;\n      });\n    },\n\n    features(features: Omit<TypeFeatures, \"pluralForm\">): TypeAfter<\"features\"> {\n      return runMethodOnce(\"features\", () => {\n        _settings = {\n          ..._settings,\n          ...features,\n        };\n        return this as TypeAfter<\"features\">;\n      });\n    },\n\n    indexes(\n      ...indexes: IndexDef<TailorDBType<Fields, User, DefinedDBTypeMetadata>>[]\n    ): TypeAfter<\"indexes\"> {\n      return runMethodOnce(\"indexes\", () => {\n        _indexes = indexes;\n        return this as TypeAfter<\"indexes\">;\n      });\n    },\n\n    files<const F extends string>(\n      files: Record<F, string> & FileKeyConflictError<Fields, User>,\n    ): TypeAfter<\"files\"> {\n      return runMethodOnce(\"files\", () => {\n        _files = files;\n        return this as TypeAfter<\"files\">;\n      });\n    },\n\n    permission<\n      U extends object = User,\n      P extends TailorTypePermission<U, output<TailorDBType<Fields, User, DefinedDBTypeMetadata>>> =\n        TailorTypePermission<U, output<TailorDBType<Fields, User, DefinedDBTypeMetadata>>>,\n    >(permission: P): TypeAfterUser<U, \"permission\"> {\n      return runMethodOnce(\"permission\", () => {\n        const ret = this as unknown as TypeAfterUser<U, \"permission\">;\n        _permissions.record = permission as RawPermissions[\"record\"];\n        return ret;\n      });\n    },\n\n    gqlPermission<\n      U extends object = User,\n      P extends TailorTypeGqlPermission<U> = TailorTypeGqlPermission<U>,\n    >(permission: P): TypeAfterUser<U, \"gqlPermission\"> {\n      return runMethodOnce(\"gqlPermission\", () => {\n        const ret = this as unknown as TypeAfterUser<U, \"gqlPermission\">;\n        _permissions.gql = permission as RawPermissions[\"gql\"];\n        return ret;\n      });\n    },\n\n    description(description: string): TypeAfter<\"description\"> {\n      return runMethodOnce(\"description\", () => {\n        _description = description;\n        this._description = description;\n        return this as TypeAfter<\"description\">;\n      });\n    },\n\n    pickFields<K extends keyof Fields, const Opt extends FieldOptions>(keys: K[], options?: Opt) {\n      const result = {} as Record<K, TailorAnyDBField>;\n      for (const key of keys) {\n        const field = this.fields[key] as TailorAnyDBField;\n        if (options) {\n          result[key] = field.clone(options);\n        } else {\n          result[key] = field;\n        }\n      }\n      // oxlint-disable-next-line no-explicit-any\n      return result as any;\n    },\n\n    omitFields<K extends keyof Fields>(keys: K[]): Omit<Fields, K> {\n      const keysSet = new Set(keys);\n      const result = {} as Record<string, TailorAnyDBField>;\n      for (const key in this.fields) {\n        if (Object.hasOwn(this.fields, key) && !keysSet.has(key as unknown as K)) {\n          result[key] = this.fields[key] as TailorAnyDBField;\n        }\n      }\n      return result as Omit<Fields, K>;\n    },\n\n    get plugins(): PluginAttachment[] {\n      return _plugins;\n    },\n\n    plugin<P extends keyof PluginConfigs<keyof Fields & string>>(config: {\n      [K in P]: PluginConfigs<keyof Fields & string>[K];\n    }): TailorDBType<Fields, User, AnyBuilderMethod> {\n      for (const [pluginId, pluginConfig] of Object.entries(config)) {\n        _plugins.push({ pluginId, config: pluginConfig });\n      }\n      return this;\n    },\n  };\n\n  return brandValue(dbType, \"tailordb-type\");\n}\n\nconst idField = uuid();\ntype idField = typeof idField;\ntype DBTable<\n  F extends { id?: never } & Record<string, TailorAnyDBField>,\n  Defined extends DefinedDBTypeMetadata = DefinedDBTypeMetadata,\n> = TailorDBInstance<{ id: idField } & F, InferredAttributes, Defined>;\n\n/**\n * Creates a new database table with the specified fields.\n * An `id` field (UUID) is automatically added to every table.\n * @param name - The name of the table, or a tuple of [name, pluralForm]\n * @param fields - The field definitions for the table\n * @returns A new TailorDB table instance\n * @example\n * export const user = db.table(\"User\", {\n *   name: db.string(),\n *   email: db.string(),\n *   age: db.int({ optional: true }),\n *   role: db.enum([\"admin\", \"member\"]),\n *   ...db.fields.timestamps(),\n * });\n * // Always export both the value and type:\n * export type user = typeof user;\n */\nfunction dbTable<const F extends { id?: never } & Record<string, TailorAnyDBField>>(\n  name: string | [string, string],\n  fields: F,\n): DBTable<F>;\n/**\n * Creates a new database table with the specified fields and description.\n * An `id` field (UUID) is automatically added to every table.\n * @param name - The name of the table, or a tuple of [name, pluralForm]\n * @param description - A description of the table\n * @param fields - The field definitions for the table\n * @returns A new TailorDB table instance\n */\nfunction dbTable<const F extends { id?: never } & Record<string, TailorAnyDBField>>(\n  name: string | [string, string],\n  description: string,\n  fields: F,\n): DBTable<F, WithDBTypeMetadata<DefinedDBTypeMetadata, \"description\">>;\nfunction dbTable<const F extends { id?: never } & Record<string, TailorAnyDBField>>(\n  name: string | [string, string],\n  fieldsOrDescription: string | F,\n  fields?: F,\n): DBTable<F> | DBTable<F, WithDBTypeMetadata<DefinedDBTypeMetadata, \"description\">> {\n  const typeName = Array.isArray(name) ? name[0] : name;\n  const pluralForm = Array.isArray(name) ? name[1] : undefined;\n\n  let description: string | undefined;\n  let fieldDef: F;\n  if (typeof fieldsOrDescription === \"string\") {\n    description = fieldsOrDescription;\n    fieldDef = fields as F;\n  } else {\n    fieldDef = fieldsOrDescription;\n  }\n  return createTailorDBType<{ id: idField } & F>(\n    typeName,\n    {\n      id: idField,\n      ...fieldDef,\n    },\n    { pluralForm, description },\n  ) as DBTable<F>;\n}\n\n/** TailorDB schema builder utilities for defining tables and fields. */\nexport const db = {\n  table: dbTable,\n  uuid,\n  string,\n  bool,\n  int,\n  float,\n  decimal,\n  date,\n  datetime,\n  time,\n  enum: _enum,\n  object,\n  fields: {\n    /**\n     * Creates standard timestamp fields (createdAt, updatedAt) with automatic defaults.\n     * Both fields default to the current time on create. updatedAt is also refreshed on update.\n     * User-specified values are respected when provided (e.g. seeding historical records).\n     * @returns An object with createdAt and updatedAt fields\n     * @example\n     * const model = db.table(\"Model\", {\n     *   name: db.string(),\n     *   ...db.fields.timestamps(),\n     * });\n     */\n    timestamps: () => ({\n      createdAt: datetime().default(\"now\").description(\"Record creation timestamp\"),\n      updatedAt: datetime()\n        .default(\"now\")\n        .hooks({ update: ({ input, now }) => input ?? now })\n        .description(\"Record update timestamp\"),\n    }),\n  },\n};\n"],"mappings":";;;;AAIA,MAAM,QAAQ;CACZ,MAAM;CACN,MAAM;CACN,MAAM;CACN,UACE;CACF,SAAS;AACX;AA6BA,SAAS,kBAA6C,MAAuC;CAC3F,MAAM,EAAE,OAAO,OAAO,WAAW,WAAW;CAC5C,MAAM,OAAO,UAAU,SAAS,IAAI,YAAY;CAChD,MAAM,oBAAoB,OAAO;CAEjC,QAAQ,MAAM,MAAd;EACE,KAAK;GACH,IAAI,OAAO,UAAU,UACnB,OAAO,KAAK;IACV,SAAS,+BAA+B,OAAO,KAAK;IACpD;GACF,CAAC;GAEH;EAEF,KAAK;GACH,IAAI,OAAO,UAAU,YAAY,CAAC,OAAO,UAAU,KAAK,GACtD,OAAO,KAAK;IACV,SAAS,iCAAiC,OAAO,KAAK;IACtD;GACF,CAAC;GAEH;EAEF,KAAK;GACH,IAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK,GACrD,OAAO,KAAK;IACV,SAAS,+BAA+B,OAAO,KAAK;IACpD;GACF,CAAC;GAEH;EAEF,KAAK;GACH,IAAI,OAAO,UAAU,WACnB,OAAO,KAAK;IACV,SAAS,gCAAgC,OAAO,KAAK;IACrD;GACF,CAAC;GAEH;EAEF,KAAK;GACH,IAAI,OAAO,UAAU,YAAY,CAAC,MAAM,KAAK,KAAK,KAAK,GACrD,OAAO,KAAK;IACV,SAAS,mCAAmC,OAAO,KAAK;IACxD;GACF,CAAC;GAEH;EACF,KAAK;GACH,IAAI,OAAO,UAAU,YAAY,CAAC,MAAM,KAAK,KAAK,KAAK,GACrD,OAAO,KAAK;IACV,SAAS,mDAAmD,OAAO,KAAK;IACxE;GACF,CAAC;GAEH;EACF,KAAK;GACH,IAAI,OAAO,UAAU,YAAY,CAAC,MAAM,SAAS,KAAK,KAAK,GACzD,OAAO,KAAK;IACV,SAAS,0CAA0C,OAAO,KAAK;IAC/D;GACF,CAAC;GAEH;EACF,KAAK;GACH,IAAI,OAAO,UAAU,YAAY,CAAC,MAAM,KAAK,KAAK,KAAK,GACrD,OAAO,KAAK;IACV,SAAS,8CAA8C,OAAO,KAAK;IACnE;GACF,CAAC;GAEH;EACF,KAAK;GACH,IAAI,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK,KAAK,GACxD,OAAO,KAAK;IACV,SAAS,uCAAuC,OAAO,KAAK;IAC5D;GACF,CAAC;GAEH;EAEF,KAAK;GACH,IAAI,MAAM,UAAU,eAAe;IACjC,MAAM,gBAAgB,MAAM,UAAU,cAAc,KAAK,MAAM,EAAE,KAAK;IACtE,IAAI,OAAO,UAAU,YAAY,CAAC,cAAc,SAAS,KAAK,GAC5D,OAAO,KAAK;KACV,SAAS,mBAAmB,cAAc,KAAK,IAAI,EAAE,cAAc,OAAO,KAAK;KAC/E;IACF,CAAC;GAEL;GACA;EAEF,KAAK,UAAU;GAGb,IACE,OAAO,UAAU,YACjB,UAAU,QACV,MAAM,QAAQ,KAAK,KACnB,iBAAiB,MACjB;IAEA,OAAO,KAAK;KACV,SAAS,gCAAgC,OAAO,KAAK;KACrD;IACF,CAAC;IACD,OAAO;GACT;GAEA,IAAI,kBAAkB;GACtB,KAAK,MAAM,CAAC,WAAW,gBAAgB,OAAO,QAAQ,MAAM,MAAM,GAAG;IACnE,MAAM,aAAc,MAAkC;IACtD,IACE,CAAC,kBAAkB;KACjB,GAAG;KACH,OAAO;KACP,OAAO;KACP,WAAW,UAAU,OAAO,SAAS;IACvC,CAAC,GAED,kBAAkB;GAEtB;GACA,OAAO;EACT;CACF;CAEA,OAAO,OAAO,WAAW;AAC3B;AAEA,SAAS,oBACP,MACA,aACM;CACN,MAAM,EAAE,OAAO,WAAW,WAAW;CACrC,MAAM,OAAO,UAAU,SAAS,IAAI,YAAY;CAEhD,KAAK,MAAM,MAAM,aAAa;EAC5B,MAAM,SAAS,GAAG,EAAE,MAAM,CAAC;EAC3B,IAAI,OAAO,WAAW,UACpB,OAAO,KAAK;GACV,SAAS;GACT;EACF,CAAC;CAEL;AACF;AAEA,SAAS,kBAA6C,MAAuC;CAC3F,MAAM,EAAE,OAAO,OAAO,WAAW,WAAW;CAC5C,MAAM,OAAO,UAAU,SAAS,IAAI,YAAY;CAEhD,MAAM,oBAAoB,UAAU,QAAQ,UAAU;CACtD,IAAI,MAAM,UAAU,YAAY,mBAAmB;EACjD,OAAO,KAAK;GACV,SAAS;GACT;EACF,CAAC;EACD,OAAO;CACT;CAEA,IAAI,CAAC,MAAM,UAAU,YAAY,mBAC/B,OAAO;CAGT,IAAI,YAAY;CAChB,IAAI,MAAM,UAAU,OAAO;EACzB,IAAI,CAAC,MAAM,QAAQ,KAAK,GAAG;GACzB,OAAO,KAAK;IACV,SAAS;IACT;GACF,CAAC;GACD,OAAO;EACT;EAEA,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAChC,IACE,CAAC,kBAAkB;GACjB,GAAG;GACH,OAAO,MAAM;GACb,WAAW,UAAU,OAAO,IAAI,EAAE,EAAE;EACtC,CAAC,GAED,YAAY;CAGlB,OACE,YAAY,kBAAkB,IAAI;CAGpC,OAAO;AACT;AAEA,SAAS,oBAA+C,MAAoC;CAC1F,MAAM,EAAE,OAAO,OAAO,cAAc;CACpC,IAAI,UAAU,QAAQ,UAAU,QAC9B;CAGF,IAAI,MAAM,SAAS,UAAU;EAC3B,MAAM,UAAU,MAAM,UAAU,QAC3B,QACD,CAAC,KAAgC;EAErC,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;GACvC,MAAM,SAAS,QAAQ;GACvB,MAAM,aAAa,MAAM,UAAU,QAAQ,UAAU,OAAO,IAAI,EAAE,EAAE,IAAI;GACxE,KAAK,MAAM,CAAC,WAAW,gBAAgB,OAAO,QAAQ,MAAM,MAAM,GAChE,oBAAoB;IAClB,GAAG;IACH,OAAO;IACP,OAAO,OAAO;IACd,WAAW,WAAW,OAAO,SAAS;GACxC,CAAC;EAEL;CACF;CAEA,MAAM,cAAc,MAAM,UAAU;CACpC,IAAI,aAAa,QACf,oBAAoB,MAAM,WAAW;AAEzC;AAEA,SAAgB,cACd,MACiC;CACjC,MAAM,EAAE,UAAU;CAClB,MAAM,SAAmC,CAAC;CAC1C,MAAM,iBAAiB;EAAE,GAAG;EAAM;CAAO;CAEzC,IADkB,kBAAkB,cACxB,GACV,oBAAoB,cAAc;CAEpC,IAAI,OAAO,SAAS,GAClB,OAAO,EAAE,OAAO;CAGlB,OAAO,EAAE,OAAQ,SAAS,KAAgB;AAC5C;;;;;;;;AAaA,SAAgB,iBAAiB,MAA8D;CAC7F,MAAM,EAAE,QAAQ,GAAG,cAAc;CACjC,OAAO,cAAc;EACnB,GAAG;EACH,OAAO;GAAE,MAAM;GAAU;GAAQ,WAAW,EAAE,UAAU,KAAK;EAAE;EAC/D,WAAW,CAAC;CACd,CAAC;AACH;;;;;;;;;ACrSA,SAAgB,iBAAiB,QAAoC;CACnE,OAAO,OAAO,KAAK,UAAU;EAC3B,IAAI,OAAO,UAAU,UACnB,OAAO;GAAE;GAAO,aAAa;EAAG;EAElC,OAAO;GAAE,GAAG;GAAO,aAAa,MAAM,eAAe;EAAG;CAC1D,CAAC;AACH;;;;ACwlBA,SAAS,qBACP,QAC8B;CAC9B,OAAO,OAAO,OAAO,SAAS;AAChC;AA4DA,SAAS,oBACP,MACA,SACA,QACA,QACQ;CACR,OAAO,2BAA2B,MAAM,SAAS,QAAQ,MAAM;AACjE;AAEA,SAAS,2BAKP,MACA,SACA,QACA,QACuD;CAIvD,MAAM,YAA6B,EAAE,UAAU,KAAK;CACpD,IAAI;CAEJ,IAAI,SAAS;EACX,IAAI,QAAQ,aAAa,MACvB,UAAU,WAAW;EAEvB,IAAI,QAAQ,UAAU,MACpB,UAAU,QAAQ;CAEtB;CACA,IAAI,QACF,UAAU,gBAAgB,iBAAiB,MAAM;CAGnD,SAASA,gBAAc,MAAmE;EACxF,OAAOC,cAAkC;GACvC,GAAG;GACH;EACF,CAAC;CACH;CAEA,SAAS,UAAU,iBAA2C;EAC5D,MAAM,SAAS,MAAM,MAAM;EAC3B,OAAO,OAAO,OAAO,WAAW,eAAe;EAC/C,OAAO;CACT;CAEA,MAAM,QAAmB;EACvB;EACA,QAAQ,UAAU,CAAC;EACnB,UAAU;EACV,SAAS;EACT;EAEA,IAAI,WAAW;GACb,OAAO,EAAE,GAAG,KAAK,UAAU;EAC7B;EAEA,IAAI,cAAuD;GACzD,OAAO,eAAe;IAAE,GAAG;IAAc,QAAQ,EAAE,GAAG,aAAa,OAAO;GAAE,IAAI;EAClF;EAEA,YAAY,aAAqB;GAC/B,OAAO,UAAU,EAAE,YAAY,CAAC;EAClC;EAEA,SAAS,UAAkB;GACzB,OAAO,UAAU,EAAE,SAAS,CAAC;EAC/B;EAEA,SAAS,GAAG,gBAAkD;GAC5D,OAAO,UAAU,EAAE,UAAU,eAAe,CAAC;EAC/C;EAEA,MAAM,MAA2D;GAC/D,OAAOD,gBAAc;IACnB,OAAO,KAAK;IACZ,MAAM,KAAK;IACX,SAAS,KAAK;IACd,WAAW,CAAC;GACd,CAAC;EACH;EAGA,SAAS,QAAyE;GAChF,MAAM,SAAS,MAAM,MAAM;GAC3B,MAAM,aAAa,qBAAqB,MAAM,IAAI,SAAS,OAAO,OAAO,KAAK;GAC9E,OAAO,gBAAgB;IACrB,MAAM,OAAO;IACb,QAAQ;KACN,MAAM;KACN,IAAI,OAAO,OAAO;KAClB,KAAK,OAAO,OAAO;IACrB;IACA,UAAU,OAAO;GACnB,CAAC;GACD,OAAO;EACT;EAEA,QAAQ;GACN,OAAO,UAAU,EAAE,OAAO,KAAK,CAAC;EAClC;EAEA,SAAS;GACP,OAAO,UAAU;IAAE,QAAQ;IAAM,OAAO;GAAK,CAAC;EAChD;EAEA,SAAS;GACP,OAAO,UAAU,EAAE,QAAQ,KAAK,CAAC;EACnC;EAGA,QAAQ,OAAY;GAElB,OAAO,UAAU,EAAE,SAAS,MAAM,CAAC;EACrC;EAEA,MAAM,OAAyB;GAC7B,OAAO,UAAU,EAAE,MAAM,CAAC;EAC5B;EAEA,OAAO,QAAsB;GAC3B,OAAO,UAAU,EAAE,QAAQ,OAAO,CAAC;EACrC;EAEA,MAAM,cAA6B;GACjC,IACE,KAAK,UAAU,UAAU,UACzB,cAAc,UAAU,UACxB,aAAa,WAAW,KAAK,UAAU,UAAU,OAEjD,MAAM,IAAI,MAAM,kEAAkE;GAIpF,IAAI,eAAe;GACnB,IAAI,QAAQ;IACV,MAAM,SAA2C,CAAC;IAClD,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAM,GAC9C,OAAO,OAAO,MAAM,MAAM;IAE5B,eAAe;GACjB;GAGA,MAAM,cAAc,2BAA2B,MAAM,SAAS,cAAc,MAAM;GAGlF,OAAO,OAAO,YAAY,WAAW,UAAU,KAAK,SAAS,CAAC;GAG9D,IAAI,cAAc;IAChB,IAAI,aAAa,aAAa,QAC5B,YAAY,UAAU,WAAW,CAAC,aAAa;IAEjD,IAAI,aAAa,UAAU,QACzB,YAAY,UAAU,QAAQ,aAAa;GAE/C;GAGA,IAAI,cACF,YAAY,gBAAgB,UAAU,YAAY,CAAC;GAGrD,OAAO;EACT;EAEA,gBAAgB,UAA6B;GAC3C,eAAe;EACjB;CACF;CAEA,OAAO;AACT;AAEA,MAAM,cAAc;;;;;;;;AASpB,SAAS,KAAqC,SAAe;CAC3D,OAAO,YAAY,QAAQ,OAAO;AACpC;;;;;;;;AASA,SAAS,OAAuC,SAAe;CAC7D,OAAO,YAAY,UAAU,OAAO;AACtC;;;;;;;;;AAUA,SAAS,KAAqC,SAAe;CAC3D,OAAO,YAAY,WAAW,OAAO;AACvC;;;;;;;;AASA,SAAS,IAAoC,SAAe;CAC1D,OAAO,YAAY,WAAW,OAAO;AACvC;;;;;;;;AASA,SAAS,MAAsC,SAAe;CAC5D,OAAO,YAAY,SAAS,OAAO;AACrC;;;;;;;;;AAcA,SAAS,QAA+C,SAAe;CACrE,IAAI,SAAS,UAAU,QACrB;MAAI,CAAC,OAAO,UAAU,QAAQ,KAAK,KAAK,QAAQ,QAAQ,KAAK,QAAQ,QAAQ,IAC3E,MAAM,IAAI,MAAM,2CAA2C;CAC7D;CAEF,MAAM,QAAQ,YAAY,WAAW,OAAO;CAC5C,IAAI,SAAS,UAAU,QACrB,MAAM,UAAU,QAAQ,QAAQ;CAElC,OAAO;AACT;;;;;;;;AASA,SAAS,KAAqC,SAAe;CAC3D,OAAO,YAAY,QAAQ,OAAO;AACpC;;;;;;;;AASA,SAAS,SAAyC,SAAe;CAC/D,OAAO,YAAY,YAAY,OAAO;AACxC;;;;;;;;AASA,SAAS,KAAqC,SAAe;CAC3D,OAAO,YAAY,QAAQ,OAAO;AACpC;;;;;;;;;AAUA,SAAS,MACP,QACA,SAIA;CACA,OAAO,YAAiD,QAAQ,SAAS,QAAW,MAAM;AAC5F;;;;;;;;;AAUA,SAAS,OAMP,QAAW,SAAe;CAC1B,OAAO,YAAY,UAAU,SAAS,MAAM;AAK9C;;;;;;;;;;AAWA,SAAS,mBAKP,MACA,QACA,SACmD;CACnD,IAAI,eAAe,QAAQ;CAC3B,IAAI,YAA0B,CAAC;CAC/B,IAAI,WAA0E,CAAC;CAC/E,MAAM,eAA+B,CAAC;CACtC,IAAI,SAAiC,CAAC;CACtC,MAAM,WAA+B,CAAC;CAEtC,IAAI;CAEJ,IAAI;CACJ,MAAM,kCAAkB,IAAI,IAAiC;CAC7D,IAAI,QAAQ,gBAAgB,QAC1B,gBAAgB,IAAI,aAAa;CAGnC,SAAS,cAAiB,QAAqC,QAAoB;EACjF,IAAI,gBAAgB,IAAI,MAAM,GAC5B,MAAM,IAAI,MAAM,IAAI,OAAO,wBAAwB;EAErD,MAAM,SAAS,OAAO;EACtB,gBAAgB,IAAI,MAAM;EAC1B,OAAO;CACT;CAWA,IAAI,QAAQ,YAAY;EACtB,IAAI,SAAS,QAAQ,YACnB,MAAM,IAAI,MAAM,wDAAwD,MAAM;EAEhF,UAAU,aAAa,QAAQ;CACjC;CAkJA,OAAO,WAAW;EA/IhB;EACA,QAAQ,EAAE,GAAG,OAAO;EACpB,SAAS;EACT;EAEA,IAAI,WAAiC;GAEnC,MAAM,UAAkE,CAAC;GACzE,IAAI,SAAS,SAAS,GACpB,SAAS,SAAS,UAAU;IAC1B,MAAM,aAAa,MAAM,OAAO,KAAK,UAAU,OAAO,KAAK,CAAC;IAC5D,MAAM,MAAM,MAAM,QAAQ,OAAO,WAAW,KAAK,GAAG;IACpD,QAAQ,OAAO;KACb,QAAQ;KACR,QAAQ,MAAM;IAChB;GACF,CAAC;GAGH,OAAO;IACL,MAAM,KAAK;IACX,aAAa;IACb,UAAU;IACV,aAAa;IACb,OAAO;IACP,GAAI,OAAO,KAAK,OAAO,CAAC,CAAC,SAAS,KAAK,EAAE,QAAQ;IACjD,GAAI,aAAa,EAAE,UAAU,UAAU;IACvC,GAAI,iBAAiB,EAAE,cAAc,cAAc;GACrD;EACF;EAEA,MAAM,MAA4C;GAChD,OAAO,cAAc,eAAe;IAClC,YAAY;IACZ,OAAO;GACT,CAAC;EACH;EAEA,SAAS,IAAmD;GAC1D,OAAO,cAAc,kBAAkB;IACrC,gBAAgB;IAChB,OAAO;GACT,CAAC;EACH;EAEA,SAAS,UAAmE;GAC1E,OAAO,cAAc,kBAAkB;IACrC,YAAY;KACV,GAAG;KACH,GAAG;IACL;IACA,OAAO;GACT,CAAC;EACH;EAEA,QACE,GAAG,SACmB;GACtB,OAAO,cAAc,iBAAiB;IACpC,WAAW;IACX,OAAO;GACT,CAAC;EACH;EAEA,MACE,OACoB;GACpB,OAAO,cAAc,eAAe;IAClC,SAAS;IACT,OAAO;GACT,CAAC;EACH;EAEA,WAIE,YAA+C;GAC/C,OAAO,cAAc,oBAAoB;IACvC,MAAM,MAAM;IACZ,aAAa,SAAS;IACtB,OAAO;GACT,CAAC;EACH;EAEA,cAGE,YAAkD;GAClD,OAAO,cAAc,uBAAuB;IAC1C,MAAM,MAAM;IACZ,aAAa,MAAM;IACnB,OAAO;GACT,CAAC;EACH;EAEA,YAAY,aAA+C;GACzD,OAAO,cAAc,qBAAqB;IACxC,eAAe;IACf,KAAK,eAAe;IACpB,OAAO;GACT,CAAC;EACH;EAEA,WAAmE,MAAW,SAAe;GAC3F,MAAM,SAAS,CAAC;GAChB,KAAK,MAAM,OAAO,MAAM;IACtB,MAAM,QAAQ,KAAK,OAAO;IAC1B,IAAI,SACF,OAAO,OAAO,MAAM,MAAM,OAAO;SAEjC,OAAO,OAAO;GAElB;GAEA,OAAO;EACT;EAEA,WAAmC,MAA4B;GAC7D,MAAM,UAAU,IAAI,IAAI,IAAI;GAC5B,MAAM,SAAS,CAAC;GAChB,KAAK,MAAM,OAAO,KAAK,QACrB,IAAI,OAAO,OAAO,KAAK,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,GAAmB,GACrE,OAAO,OAAO,KAAK,OAAO;GAG9B,OAAO;EACT;EAEA,IAAI,UAA8B;GAChC,OAAO;EACT;EAEA,OAA6D,QAEZ;GAC/C,KAAK,MAAM,CAAC,UAAU,iBAAiB,OAAO,QAAQ,MAAM,GAC1D,SAAS,KAAK;IAAE;IAAU,QAAQ;GAAa,CAAC;GAElD,OAAO;EACT;CAGqB,GAAG,eAAe;AAC3C;AAEA,MAAM,UAAU,KAAK;AAyCrB,SAAS,QACP,MACA,qBACA,QACmF;CACnF,MAAM,WAAW,MAAM,QAAQ,IAAI,IAAI,KAAK,KAAK;CACjD,MAAM,aAAa,MAAM,QAAQ,IAAI,IAAI,KAAK,KAAK;CAEnD,IAAI;CACJ,IAAI;CACJ,IAAI,OAAO,wBAAwB,UAAU;EAC3C,cAAc;EACd,WAAW;CACb,OACE,WAAW;CAEb,OAAO,mBACL,UACA;EACE,IAAI;EACJ,GAAG;CACL,GACA;EAAE;EAAY;CAAY,CAC5B;AACF;;AAGA,MAAa,KAAK;CAChB,OAAO;CACP;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA,MAAM;CACN;CACA,QAAQ;;;;;;;;;;;;AAYN,mBAAmB;EACjB,WAAW,SAAS,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,YAAY,2BAA2B;EAC5E,WAAW,SAAS,CAAC,CAClB,QAAQ,KAAK,CAAC,CACd,MAAM,EAAE,SAAS,EAAE,OAAO,UAAU,SAAS,IAAI,CAAC,CAAC,CACnD,YAAY,yBAAyB;CAC1C,GACF;AACF"}

package/dist/seed/index.d.mts

@@ -14,13 +14,62 @@ type ValidateSeedResult = {
   output: string;
   error: string;
 };
+/**
+ * A JSONL seed file that received values.
+ */
+type FilledSeedFile = {
+  /** Name of the seeded type, matching the JSONL file name */
+  table: string;
+  /** Absolute path to the updated JSONL file */
+  file: string;
+  /** Fields that were written back to the file */
+  fields: string[];
+  /** How many rows were missing at least one of those fields */
+  count: number;
+};
+type FillSeedDataOptions = {
+  /** Resolved absolute path to a data directory or a .jsonl file */
+  path: string;
+  /** Fields to fill. Defaults to `id`. */
+  fields?: readonly string[];
+};
+type FillSeedDataResult = {
+  output: string;
+  filled: FilledSeedFile[];
+};
 /**
  * Validate JSONL seed data against schema definitions.
- * Resolves the given path (directory or `.jsonl` file), runs LinesDB
- * validation, and returns formatted output and error messages.
+ * Resolves the given path (directory or `.jsonl` file), validates the rows it
+ * holds, and returns formatted output and error messages.
  * @param options - Validation options including path and verbose flag
  * @returns Validation result with output messages and optional error details
  */
 declare function validateSeedData(options: ValidateSeedDataOptions): Promise<ValidateSeedResult>;
+/**
+ * Fill in the values a record gets on create for the JSONL seed data rows that
+ * are missing them, so a row can be referenced by `id` or carry a timestamp
+ * before it is ever seeded.
+ *
+ * The values come from the type's own create-time behavior — its `id`, its field
+ * defaults, and its create hooks — applied to each row on its own. Nothing is
+ * validated, so a row can be filled while the data around it is still
+ * incomplete: that is what lets you get the ids you need in order to write the
+ * rows that reference them. Run `validateSeedData` when the data is ready.
+ *
+ * Only the named fields are written, and only into a row that has no value for
+ * them, so a value already in the file is never replaced. A line that gains
+ * nothing is written back exactly as it was, byte for byte; a line that does get
+ * a value is re-serialized with its keys in the order the type declares its
+ * fields, so a filled-in `id` lands at the front. A field the type gives no
+ * value to — one it does not declare, or one the platform assigns such as a
+ * serial field — is skipped, so one field list covers a whole data directory.
+ *
+ * The values are read from the schema files generated next to the data, and all
+ * of them are read before anything is written: a file that predates the current
+ * generator stops the run with nothing filled in anywhere.
+ * @param options - Fill options including path and fields
+ * @returns Which files received which fields
+ */
+declare function fillSeedData(options: FillSeedDataOptions): Promise<FillSeedDataResult>;
 //#endregion
-export { type ForeignKeyDefinition, type IndexDefinition, defineSchema, validateSeedData };
+export { type ForeignKeyDefinition, type IndexDefinition, defineSchema, fillSeedData, validateSeedData };