Skip to main content
The session service handles the creation and management of clipboard sync sessions. Sessions allow multiple devices to share clipboard content using unique session codes.

​
createSession

Creates a new clipboard sync session with a randomly generated 5-character code. 
export const createSession = async (setSessionCode) => {
    const characters = "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
    let newCode = "";
    for (let i = 0; i < 5; i++) {
        newCode += characters.charAt(Math.floor(Math.random() * characters.length));
    }

    await supabase.from("sessions").insert([{ code: newCode }]);

    setSessionCode(newCode);
    localStorage.setItem("sessionCode", newCode);
};
Source: src/service/doc.service.js:3

​
Parameters

​
setSessionCode
function
required
State setter function to update the session code in the component state. This function receives the newly generated session code as its argument.

​
Return Value

Returns a Promise<void> that resolves when the session has been created and stored.

​
Behavior

  1. Code Generation: Generates a 5-character alphanumeric code using uppercase letters (A-Z) and digits (0-9)
  2. Database Storage: Inserts the new session code into the sessions table in Supabase
  3. State Update: Calls the provided setSessionCode function with the new code
  4. Local Persistence: Stores the session code in localStorage under the key sessionCode

​
Code Generation Algorithm

The function uses a simple random character selection algorithm:
  • Character set: ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789 (36 possible characters)
  • Code length: 5 characters
  • Total possible combinations: 36^5 = 60,466,176 unique codes

​
Database Interaction

The function interacts with Supabase by:
  • Inserting a new record into the sessions table
  • Schema: { code: string }
  • No error handling is implemented in the function itself

​
Usage Example

import { createSession } from "./service/doc.service";
import { useState } from "react";

function MyComponent() {
  const [sessionCode, setSessionCode] = useState("");
  
  const handleCreateSession = async () => {
    await createSession(setSessionCode);
    console.log("Session created:", sessionCode);
  };
  
  return (
    <button onClick={handleCreateSession}>
      Create New Session
    </button>
  );
}
```javascript

### Storage Locations

- **Database**: Supabase `sessions` table
- **Local Storage**: Key `sessionCode` (persists across browser sessions)
- **Component State**: Via the `setSessionCode` callback

Build docs developers (and LLMs) love

Get started for freeTalk to us