Fake Mirrors
    Preparing search index...

    Class RedisLureRepository

    Redis-based lure repository implementation.

    Depends:

    import { DIContainer } from '@famir/common'
    import { RedisLureRepository } from '@famir/database'

    // Get container singleton
    const container = DIContainer.getInstance()

    // Register dependency in container
    RedisLureRepository.register(container)

    import { DIContainer } from '@famir/common'
    import { LURE_REPOSITORY, LureRepository } from '@famir/domain'

    // Get container singleton
    const container = DIContainer.getInstance()

    // Resolve dependency from container
    const lureRepository = container.resolve<LureRepository>(LURE_REPOSITORY)

    // Read 'test' lure from 'httpbin' campaign
    const lure = await lureRepository.read('httpbin', 'test')
    console.log(lure)

    Hierarchy (View Summary)

    Implements

    • Creates a new lure.

      The lure will be created in a disabled state (isEnabled = false). Use enable to activate it for traffic routing.

      Parameters

      • campaignId: string

        The ID of the campaign to create the lure in.

      • lureId: string

        The new lure ID to create.

      • path: string

        The URL path for the lure.

      • redirectorId: string

        The ID of the redirector that handles this lure.

      • lockSecret: string

        The campaign lock secret obtained from CampaignRepository.lock.

      Returns Promise<void>

      DatabaseError If the campaign does not exist.

      DatabaseError If the campaign is not locked.

      DatabaseError If the campaign lock secret does not match.

      DatabaseError If a lure with the same ID already exists.

      DatabaseError If the lure URL path is already used by another campaign.

      DatabaseError If the redirector does not exist.

      DatabaseError If the data validation fails.

    • Deletes the lure by its ID.

      A lure must be disabled before it can be deleted.

      Parameters

      • campaignId: string

        The ID of the campaign containing the lure.

      • lureId: string

        The lure ID to delete.

      • redirectorId: string

        The ID of the redirector that handles this lure.

      • lockSecret: string

        The campaign lock secret obtained from CampaignRepository.lock.

      Returns Promise<void>

      DatabaseError If the campaign does not exist.

      DatabaseError If the campaign is not locked.

      DatabaseError If the campaign lock secret does not match.

      DatabaseError If the lure does not exist.

      DatabaseError If the redirector does not exist.

      DatabaseError If the lure is still enabled.

      DatabaseError If the lure redirector ID does not match the provided one.

      DatabaseError If the data validation fails.

    • Disables the lure, stopping request routing.

      When disabled, requests to the URL path will not be routed.

      Parameters

      • campaignId: string

        The ID of the campaign containing the lure.

      • lureId: string

        The lure ID to disable.

      • lockSecret: string

        The campaign lock secret obtained from CampaignRepository.lock.

      Returns Promise<void>

      DatabaseError If the campaign does not exist.

      DatabaseError If the campaign is not locked.

      DatabaseError If the campaign lock secret does not match.

      DatabaseError If the lure does not exist.

      DatabaseError If the data validation fails.

    • Enables the lure, making it available for request routing.

      When enabled, the URL path becomes active and can be used to serve the associated redirector content.

      Parameters

      • campaignId: string

        The ID of the campaign containing the lure.

      • lureId: string

        The lure ID to enable.

      • lockSecret: string

        The campaign lock secret obtained from CampaignRepository.lock.

      Returns Promise<void>

      DatabaseError If the campaign does not exist.

      DatabaseError If the campaign is not locked.

      DatabaseError If the campaign lock secret does not match.

      DatabaseError If the lure does not exist.

      DatabaseError If the data validation fails.

    • Finds a lure by its URL path.

      This is the primary routing method for HTTP requests. When a request arrives at a mirror domain, the request path is extracted and used to instantly find the corresponding lure via a direct hash lookup.

      Parameters

      • campaignId: string

        The ID of the campaign to search in.

      • path: string

        The URL path to look up.

      Returns Promise<LureModel | null>

      The lure model, or null if no lure matches the URL path.

      DatabaseError If the data validation fails.

    • Lists all lures for the campaign.

      Lures are ordered by creation time (oldest first).

      Parameters

      • campaignId: string

        The ID of the campaign to list lures for.

      Returns Promise<LureModel[] | null>

      The array of lure models, or null if the campaign does not exist.

      DatabaseError If the data validation fails.

    • Reads the lure by its ID.

      Parameters

      • campaignId: string

        The ID of the campaign containing the lure.

      • lureId: string

        The lure ID to read.

      Returns Promise<LureModel | null>

      The lure model, or null if the lure is not found.

      DatabaseError If the data validation fails.

    • Registers the lure repository as a singleton in the DI container.

      Parameters

      • container: DIContainer

        The DI container to register in.

      Returns void

    Constructors
    Methods