@uuid4

Auto-generates a random v4 UUID when a record is created and the field is not provided. Uses SurrealDB's rand::uuid::v4() function.

Syntax

model Token {
  id Record @id
  sessionId Uuid @uuid4
}

Behavior

Same behavior as @uuid, but explicitly generates a v4 (random) UUID:

• Uuid fields only — can only be applied to Uuid type fields.
• Set on creation — generated when the field is absent. Your value is used if provided.
• Optional in CreateInput — the field becomes optional in create types.
• Random ordering — v4 UUIDs are fully random with no time component, so they don't sort chronologically.

Usage

const token = await db.Token.create({
  data: {
    /* sessionId is optional — auto-generated as v4 */
  },
});
console.log(token.sessionId); // CerialUuid — random v4

Allowed On

• Model fields (Uuid type)
• Object sub-fields (Uuid type)