PrimaryKey

Extracts the string value from a PrimaryKey.

When to use

Use to read the stable string identifier from a value that implements PrimaryKey.

declare function value(self: PrimaryKey): string

import { PrimaryKey } from "effect"

class OrderId implements PrimaryKey.PrimaryKey {
  constructor(private timestamp: number, private sequence: number) {}

  [PrimaryKey.symbol](): string {
    return `order_${this.timestamp}_${this.sequence}`
  }
}

const orderId = new OrderId(1640995200000, 1)
PrimaryKey.value(orderId) // => "order_1640995200000_1"

// Can also be used with simple string-based implementations
const simpleKey = {
  [PrimaryKey.symbol]: () => "simple-key-123"
}
PrimaryKey.value(simpleKey) // => "simple-key-123"

Checks whether a value implements the PrimaryKey protocol.

When to use

Use to narrow an unknown value before treating it as a PrimaryKey.

Details

This is a structural guard for the PrimaryKey.symbol property.

Gotchas

This guard does not call the method or verify that it returns a string.

See

• PrimaryKey for the protocol being checked
• value for extracting the string value after narrowing

declare function isPrimaryKey(u: unknown): u is PrimaryKey

An interface for objects that can provide a string-based primary key.

When to use

Use to define values that expose a stable string identifier for equality, hashing, caching, or persistence.

Details

Objects implementing this interface must provide a method that returns a unique string identifier.

interface PrimaryKey {
  "~effect/interfaces/PrimaryKey"(): string;
}

import { PrimaryKey } from "effect"

class ProductId implements PrimaryKey.PrimaryKey {
  constructor(private category: string, private id: number) {}

  [PrimaryKey.symbol](): string {
    return `${this.category}-${this.id}`
  }
}

const productId = new ProductId("electronics", 42)
PrimaryKey.value(productId) // => "electronics-42"

Defines the unique identifier used to identify objects that implement the PrimaryKey interface.

When to use

Use to implement the PrimaryKey protocol as a computed property key on classes or object literals that expose a stable string identifier.

See

• PrimaryKey for the protocol interface that declares the method keyed by this symbol
• value for reading the string key from a PrimaryKey value
• isPrimaryKey for checking whether an unknown value carries this method

declare const symbol: "~effect/interfaces/PrimaryKey"