# ouidNew()

The `ouidNew()` function generates a unique identifier string suitable for use as database keys, session IDs, or any other scenario requiring unique values.

```javascript
// Generate a unique ID
id = ouidNew()
```

## Syntax

```javascript
ouidNew()
```

## Parameters

This function doesn't take any parameters.

## Return Value

Returns a string containing a cryptographically strong unique identifier.

## Description

The `ouidNew()` function creates unique identifiers by combining several sources of entropy including:

* Current timestamp
* System performance metrics
* User's unique identifier

The result is then hashed using SHA-256 to create a fixed-length unique string that's suitable for:

* Database record identifiers
* Session or authentication tokens
* Unique filenames
* Entity tracking in applications
* Temporary identifiers for objects

## Examples

### Basic Usage

```javascript
// Generate a simple unique ID
id = ouidNew()
log id  // Outputs something like "7f83b1657ff1fc53b92dc18148a1d65dfc2d4b1fa3d677284addd200126d9069"
```

### Creating Unique Database Records

```javascript
// Create a new user record with a unique ID
def createUser(name, email) (
  user = {
    id: ouidNew(),
    name: name,
    email: email,
    created: timestamp()
  }
  
  // Store the user in the database
  users = localDbGet("users") ?? []
  users.push(user)
  localDbSet("users", users)
  
  return user.id
)
```

### Generating Unique Filenames

```javascript
// Create a unique filename for storing user uploads
def generateUniqueFilename(originalName) (
  // Extract file extension
  extension = originalName.split(".").pop()
  
  // Generate unique name with original extension
  return ouidNew() + "." + extension
)

// Usage
newFilename = generateUniqueFilename("profile.jpg")
```

### Creating Temporary Tokens

```javascript
// Generate a password reset token that expires
def createPasswordResetToken(userId) (
  token = ouidNew()
  
  // Store the token with expiration time
  localDbSet("reset_token_" + userId, {
    token: token,
    expires: timestamp() + 3600  // Expires in 1 hour
  })
  
  return token
)
```

## Notes

* The generated IDs are cryptographically strong and suitable for most applications
* The function generates a different ID on every call
* The length and format of the ID is consistent across all calls
* For extremely high-volume systems with thousands of IDs per second, consider monitoring for potential collisions
* The function generates strings that are suitable for use in URLs and filenames


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://osl.mistium.com/functions/ouidnew.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.