bunqueue-client 0.1.9 → 0.2.0

package/dist/types/src/domain/types/commands/extended.d.ts

@@ -0,0 +1,63 @@
+import type { BaseCommand } from "./base.js";
+export interface ClearLogsCommand extends BaseCommand {
+    readonly cmd: 'ClearLogs';
+    readonly id: string;
+    readonly keepLogs?: number;
+}
+export interface ExtendLockCommand extends BaseCommand {
+    readonly cmd: 'ExtendLock';
+    readonly id: string;
+    readonly token?: string;
+    readonly duration: number;
+}
+export interface ExtendLocksCommand extends BaseCommand {
+    readonly cmd: 'ExtendLocks';
+    readonly ids: string[];
+    readonly tokens: string[];
+    readonly durations: number[];
+}
+export interface ChangeDelayCommand extends BaseCommand {
+    readonly cmd: 'ChangeDelay';
+    readonly id: string;
+    readonly delay: number;
+    readonly token?: string;
+}
+export interface SetWebhookEnabledCommand extends BaseCommand {
+    readonly cmd: 'SetWebhookEnabled';
+    readonly id: string;
+    readonly enabled: boolean;
+}
+export interface CompactMemoryCommand extends BaseCommand {
+    readonly cmd: 'CompactMemory';
+}
+export interface UpdateParentCommand extends BaseCommand {
+    readonly cmd: 'UpdateParent';
+    readonly childId: string;
+    readonly parentId: string;
+}
+export interface GetFailedChildrenValuesCommand extends BaseCommand {
+    readonly cmd: 'GetFailedChildrenValues';
+    readonly id: string;
+}
+export interface GetIgnoredChildrenFailuresCommand extends BaseCommand {
+    readonly cmd: 'GetIgnoredChildrenFailures';
+    readonly id: string;
+}
+export interface RemoveChildDependencyCommand extends BaseCommand {
+    readonly cmd: 'RemoveChildDependency';
+    readonly id: string;
+}
+export interface RemoveUnprocessedChildrenCommand extends BaseCommand {
+    readonly cmd: 'RemoveUnprocessedChildren';
+    readonly id: string;
+}
+export interface MoveToWaitCommand extends BaseCommand {
+    readonly cmd: 'MoveToWait';
+    readonly id: string;
+    readonly token?: string;
+}
+export interface PromoteJobsCommand extends BaseCommand {
+    readonly cmd: 'PromoteJobs';
+    readonly queue: string;
+    readonly count?: number;
+}

package/dist/types/src/domain/types/commands/index.d.ts

@@ -0,0 +1,12 @@
+export * from "./core.js";
+export * from "./cron.js";
+export * from "./dashboard.js";
+export * from "./dlq.js";
+export * from "./extended.js";
+export * from "./limits.js";
+export * from "./management.js";
+export * from "./monitoring.js";
+export * from "./protocol.js";
+export * from "./query.js";
+export * from "./union.js";
+export * from "./workers.js";

package/dist/types/src/domain/types/commands/limits.d.ts

@@ -0,0 +1,108 @@
+import type { BaseCommand } from "./base.js";
+export interface GetQueueLimitsCommand extends BaseCommand {
+    readonly cmd: 'GetQueueLimits';
+    readonly queue: string;
+    readonly maxJobs?: number;
+}
+export interface GetDeduplicationJobIdCommand extends BaseCommand {
+    readonly cmd: 'GetDeduplicationJobId';
+    readonly queue: string;
+    readonly deduplicationId: string;
+}
+export interface RemoveDeduplicationKeyCommand extends BaseCommand {
+    readonly cmd: 'RemoveDeduplicationKey';
+    readonly queue: string;
+    readonly deduplicationId: string;
+}
+export interface RemoveJobDeduplicationKeyCommand extends BaseCommand {
+    readonly cmd: 'RemoveJobDeduplicationKey';
+    readonly id: string;
+}
+export interface MoveToWaitingChildrenCommand extends BaseCommand {
+    readonly cmd: 'MoveToWaitingChildren';
+    readonly id: string;
+    readonly token?: string;
+}
+export interface RateLimitCommand extends BaseCommand {
+    readonly cmd: 'RateLimit';
+    readonly queue: string;
+    readonly limit: number;
+    readonly duration?: number;
+    readonly ttl?: number;
+}
+export interface SetConcurrencyCommand extends BaseCommand {
+    readonly cmd: 'SetConcurrency';
+    readonly queue: string;
+    readonly limit: number;
+}
+export interface RateLimitClearCommand extends BaseCommand {
+    readonly cmd: 'RateLimitClear';
+    readonly queue: string;
+}
+export interface ClearConcurrencyCommand extends BaseCommand {
+    readonly cmd: 'ClearConcurrency';
+    readonly queue: string;
+}
+export interface SetStallConfigCommand extends BaseCommand {
+    readonly cmd: 'SetStallConfig';
+    readonly queue: string;
+    readonly config: Record<string, unknown>;
+}
+export interface GetStallConfigCommand extends BaseCommand {
+    readonly cmd: 'GetStallConfig';
+    readonly queue: string;
+}
+interface GroupCommand extends BaseCommand {
+    readonly queue: string;
+    readonly groupId: string;
+}
+export interface GetGroupJobsCountCommand extends GroupCommand {
+    readonly cmd: 'GetGroupJobsCount';
+}
+export interface GetGroupsJobsCountCommand extends BaseCommand {
+    readonly cmd: 'GetGroupsJobsCount';
+    readonly queue: string;
+    readonly maxCount?: number;
+}
+export interface GetGroupActiveCountCommand extends GroupCommand {
+    readonly cmd: 'GetGroupActiveCount';
+}
+export interface SetGroupRateLimitCommand extends GroupCommand {
+    readonly cmd: 'SetGroupRateLimit';
+    readonly max: number;
+    readonly duration: number;
+}
+export interface GetGroupRateLimitCommand extends GroupCommand {
+    readonly cmd: 'GetGroupRateLimit';
+}
+export interface RemoveGroupRateLimitCommand extends GroupCommand {
+    readonly cmd: 'RemoveGroupRateLimit';
+}
+export interface GetGroupRateLimitTtlCommand extends GroupCommand {
+    readonly cmd: 'GetGroupRateLimitTtl';
+    readonly maxJobs?: number;
+}
+export interface SetGroupConcurrencyCommand extends GroupCommand {
+    readonly cmd: 'SetGroupConcurrency';
+    readonly concurrency: number;
+}
+export interface GetGroupConcurrencyCommand extends GroupCommand {
+    readonly cmd: 'GetGroupConcurrency';
+}
+export interface RemoveGroupConcurrencyCommand extends GroupCommand {
+    readonly cmd: 'RemoveGroupConcurrency';
+}
+export interface PauseGroupCommand extends GroupCommand {
+    readonly cmd: 'PauseGroup';
+}
+export interface ResumeGroupCommand extends GroupCommand {
+    readonly cmd: 'ResumeGroup';
+}
+export interface IsGroupPausedCommand extends GroupCommand {
+    readonly cmd: 'IsGroupPaused';
+}
+export interface RateLimitGroupCommand extends GroupCommand {
+    readonly cmd: 'RateLimitGroup';
+    readonly duration: number;
+}
+export {};

package/dist/types/src/domain/types/commands/management.d.ts

@@ -0,0 +1,73 @@
+import type { JobState } from "../job.js";
+import type { BaseCommand } from "./base.js";
+export interface CancelCommand extends BaseCommand {
+    readonly cmd: 'Cancel';
+    readonly id: string;
+}
+export interface ProgressCommand extends BaseCommand {
+    readonly cmd: 'Progress';
+    readonly id: string;
+    readonly progress: number;
+    readonly message?: string;
+}
+export interface UpdateCommand extends BaseCommand {
+    readonly cmd: 'Update';
+    readonly id: string;
+    readonly data: unknown;
+}
+export interface ChangePriorityCommand extends BaseCommand {
+    readonly cmd: 'ChangePriority';
+    readonly id: string;
+    readonly priority: number;
+    readonly lifo?: boolean;
+}
+export interface PromoteCommand extends BaseCommand {
+    readonly cmd: 'Promote';
+    readonly id: string;
+}
+export interface WaitJobCommand extends BaseCommand {
+    readonly cmd: 'WaitJob';
+    readonly id: string;
+    readonly timeout?: number;
+}
+export interface MoveToDelayedCommand extends BaseCommand {
+    readonly cmd: 'MoveToDelayed';
+    readonly id: string;
+    readonly delay: number;
+    readonly token?: string;
+}
+export interface DiscardCommand extends BaseCommand {
+    readonly cmd: 'Discard';
+    readonly id: string;
+    readonly token?: string;
+}
+export interface PauseCommand extends BaseCommand {
+    readonly cmd: 'Pause';
+    readonly queue: string;
+}
+export interface ResumeCommand extends BaseCommand {
+    readonly cmd: 'Resume';
+    readonly queue: string;
+}
+export interface IsPausedCommand extends BaseCommand {
+    readonly cmd: 'IsPaused';
+    readonly queue: string;
+}
+export interface DrainCommand extends BaseCommand {
+    readonly cmd: 'Drain';
+    readonly queue: string;
+}
+export interface ObliterateCommand extends BaseCommand {
+    readonly cmd: 'Obliterate';
+    readonly queue: string;
+}
+export interface ListQueuesCommand extends BaseCommand {
+    readonly cmd: 'ListQueues';
+}
+export interface CleanCommand extends BaseCommand {
+    readonly cmd: 'Clean';
+    readonly queue: string;
+    readonly grace: number;
+    readonly state?: JobState;
+    readonly limit?: number;
+}

package/dist/types/src/domain/types/commands/monitoring.d.ts

@@ -0,0 +1,49 @@
+import type { BaseCommand } from "./base.js";
+export interface AddLogCommand extends BaseCommand {
+    readonly cmd: 'AddLog';
+    readonly id: string;
+    readonly message: string;
+    readonly level?: 'info' | 'warn' | 'error';
+}
+export interface GetLogsCommand extends BaseCommand {
+    readonly cmd: 'GetLogs';
+    readonly id: string;
+    readonly start?: number;
+    readonly end?: number;
+}
+export interface AddWebhookCommand extends BaseCommand {
+    readonly cmd: 'AddWebhook';
+    readonly url: string;
+    readonly events: string[];
+    readonly queue?: string;
+    readonly secret?: string;
+}
+export interface RemoveWebhookCommand extends BaseCommand {
+    readonly cmd: 'RemoveWebhook';
+    readonly webhookId: string;
+}
+export interface ListWebhooksCommand extends BaseCommand {
+    readonly cmd: 'ListWebhooks';
+}
+export interface StatsCommand extends BaseCommand {
+    readonly cmd: 'Stats';
+}
+export interface MetricsCommand extends BaseCommand {
+    readonly cmd: 'Metrics';
+    /** Omitted fields retain the legacy broker-wide metrics response. */
+    readonly queue?: string;
+    readonly type?: 'completed' | 'failed';
+    readonly start?: number;
+    readonly end?: number;
+}
+export interface TrimEventsCommand extends BaseCommand {
+    readonly cmd: 'TrimEvents';
+    readonly queue: string;
+    readonly maxLength: number;
+}
+export interface PrometheusCommand extends BaseCommand {
+    readonly cmd: 'Prometheus';
+}
+export interface StorageStatusCommand extends BaseCommand {
+    readonly cmd: 'StorageStatus';
+}

package/dist/types/src/domain/types/commands/protocol.d.ts

@@ -0,0 +1,20 @@
+import type { BaseCommand } from "./base.js";
+import type { ProtocolCapability } from "../protocol.js";
+export interface AuthCommand extends BaseCommand {
+    readonly cmd: 'Auth';
+    readonly token: string;
+}
+export interface HelloCommand extends BaseCommand {
+    readonly cmd: 'Hello';
+    readonly protocolVersion: number;
+    readonly capabilities?: ProtocolCapability[];
+}
+/** Subscribe this TCP connection to one queue's lifecycle event stream. */
+export interface SubscribeEventsCommand extends BaseCommand {
+    readonly cmd: 'SubscribeEvents';
+    readonly queue: string;
+}
+/** Remove the lifecycle event subscription owned by this TCP connection. */
+export interface UnsubscribeEventsCommand extends BaseCommand {
+    readonly cmd: 'UnsubscribeEvents';
+}

package/dist/types/src/domain/types/commands/query.d.ts

@@ -0,0 +1,46 @@
+import type { JobState } from "../job.js";
+import type { BaseCommand } from "./base.js";
+export interface GetJobCommand extends BaseCommand {
+    readonly cmd: 'GetJob';
+    readonly id: string;
+}
+export interface GetStateCommand extends BaseCommand {
+    readonly cmd: 'GetState';
+    readonly id: string;
+}
+export interface GetResultCommand extends BaseCommand {
+    readonly cmd: 'GetResult';
+    readonly id: string;
+}
+export interface GetJobsCommand extends BaseCommand {
+    readonly cmd: 'GetJobs';
+    readonly queue: string;
+    readonly state?: JobState | JobState[];
+    readonly limit?: number;
+    readonly offset?: number;
+    readonly asc?: boolean;
+}
+export interface GetJobCountsCommand extends BaseCommand {
+    readonly cmd: 'GetJobCounts';
+    readonly queue: string;
+}
+export interface GetCountsPerPriorityCommand extends BaseCommand {
+    readonly cmd: 'GetCountsPerPriority';
+    readonly queue: string;
+}
+export interface GetJobByCustomIdCommand extends BaseCommand {
+    readonly cmd: 'GetJobByCustomId';
+    readonly customId: string;
+}
+export interface CountCommand extends BaseCommand {
+    readonly cmd: 'Count';
+    readonly queue: string;
+}
+export interface GetProgressCommand extends BaseCommand {
+    readonly cmd: 'GetProgress';
+    readonly id: string;
+}
+export interface GetChildrenValuesCommand extends BaseCommand {
+    readonly cmd: 'GetChildrenValues';
+    readonly id: string;
+}

package/dist/types/src/domain/types/commands/union.d.ts

@@ -0,0 +1,13 @@
+import type * as Core from "./core.js";
+import type * as Cron from "./cron.js";
+import type * as Dashboard from "./dashboard.js";
+import type * as Dlq from "./dlq.js";
+import type * as Extended from "./extended.js";
+import type * as Limits from "./limits.js";
+import type * as Management from "./management.js";
+import type * as Monitoring from "./monitoring.js";
+import type * as Protocol from "./protocol.js";
+import type * as Query from "./query.js";
+import type * as Workers from "./workers.js";
+export type Command = Core.PushCommand | Core.PushBatchCommand | Core.PushFlowCommand | Core.PullCommand | Core.PullBatchCommand | Core.AckCommand | Core.AckBatchCommand | Core.FailCommand | Query.GetJobCommand | Query.GetStateCommand | Query.GetResultCommand | Query.GetJobsCommand | Query.GetJobCountsCommand | Query.GetCountsPerPriorityCommand | Query.GetJobByCustomIdCommand | Query.CountCommand | Query.GetProgressCommand | Query.GetChildrenValuesCommand | Management.CancelCommand | Management.ProgressCommand | Management.UpdateCommand | Management.ChangePriorityCommand | Management.PromoteCommand | Management.WaitJobCommand | Management.MoveToDelayedCommand | Management.DiscardCommand | Management.PauseCommand | Management.ResumeCommand | Management.IsPausedCommand | Management.DrainCommand | Management.ObliterateCommand | Management.ListQueuesCommand | Management.CleanCommand | Dlq.DlqCommand | Dlq.GetDlqStatsCommand | Dlq.RetryDlqCommand | Dlq.PurgeDlqCommand | Dlq.RemoveDlqJobCommand | Dlq.RetryCompletedCommand | Dlq.SetDlqConfigCommand | Dlq.GetDlqConfigCommand | Limits.GetQueueLimitsCommand | Limits.GetDeduplicationJobIdCommand | Limits.RemoveDeduplicationKeyCommand | Limits.RemoveJobDeduplicationKeyCommand | Limits.MoveToWaitingChildrenCommand | Limits.RateLimitCommand | Limits.SetConcurrencyCommand | Limits.RateLimitClearCommand | Limits.ClearConcurrencyCommand | Limits.SetStallConfigCommand | Limits.GetStallConfigCommand | Limits.GetGroupJobsCountCommand | Limits.GetGroupsJobsCountCommand | Limits.GetGroupActiveCountCommand | Limits.SetGroupRateLimitCommand | Limits.GetGroupRateLimitCommand | Limits.RemoveGroupRateLimitCommand | Limits.GetGroupRateLimitTtlCommand | Limits.SetGroupConcurrencyCommand | Limits.GetGroupConcurrencyCommand | Limits.RemoveGroupConcurrencyCommand | Limits.PauseGroupCommand | Limits.ResumeGroupCommand | Limits.IsGroupPausedCommand | Limits.RateLimitGroupCommand | Cron.CronCommand | Cron.CronDeleteCommand | Cron.CronListCommand | Cron.CronGetCommand | Monitoring.AddLogCommand | Monitoring.GetLogsCommand | Monitoring.AddWebhookCommand | Monitoring.RemoveWebhookCommand | Monitoring.ListWebhooksCommand | Monitoring.StatsCommand | Monitoring.MetricsCommand | Monitoring.TrimEventsCommand | Monitoring.PrometheusCommand | Monitoring.StorageStatusCommand | Workers.HeartbeatCommand | Workers.JobHeartbeatCommand | Workers.JobHeartbeatBatchCommand | Workers.PingCommand | Workers.RegisterWorkerCommand | Workers.UnregisterWorkerCommand | Workers.ListWorkersCommand | Extended.ClearLogsCommand | Extended.ExtendLockCommand | Extended.ExtendLocksCommand | Extended.ChangeDelayCommand | Extended.SetWebhookEnabledCommand | Extended.CompactMemoryCommand | Extended.UpdateParentCommand | Extended.GetFailedChildrenValuesCommand | Extended.GetIgnoredChildrenFailuresCommand | Extended.RemoveChildDependencyCommand | Extended.RemoveUnprocessedChildrenCommand | Extended.MoveToWaitCommand | Extended.PromoteJobsCommand | Dashboard.DashboardOverviewCommand | Dashboard.DashboardQueuesCommand | Dashboard.DashboardQueueCommand | Protocol.AuthCommand | Protocol.HelloCommand | Protocol.SubscribeEventsCommand | Protocol.UnsubscribeEventsCommand;
+export type CommandType = Command['cmd'];

package/dist/types/src/domain/types/commands/workers.d.ts

@@ -0,0 +1,39 @@
+import type { BaseCommand } from "./base.js";
+export interface HeartbeatCommand extends BaseCommand {
+    readonly cmd: 'Heartbeat';
+    readonly id: string;
+    readonly activeJobs?: number;
+    readonly processed?: number;
+    readonly failed?: number;
+}
+export interface JobHeartbeatCommand extends BaseCommand {
+    readonly cmd: 'JobHeartbeat';
+    readonly id: string;
+    readonly token?: string;
+    readonly duration?: number;
+}
+export interface JobHeartbeatBatchCommand extends BaseCommand {
+    readonly cmd: 'JobHeartbeatB';
+    readonly ids: string[];
+    readonly tokens?: string[];
+}
+export interface PingCommand extends BaseCommand {
+    readonly cmd: 'Ping';
+}
+export interface RegisterWorkerCommand extends BaseCommand {
+    readonly cmd: 'RegisterWorker';
+    readonly name: string;
+    readonly queues: string[];
+    readonly concurrency?: number;
+    readonly workerId?: string;
+    readonly hostname?: string;
+    readonly pid?: number;
+    readonly startedAt?: number;
+}
+export interface UnregisterWorkerCommand extends BaseCommand {
+    readonly cmd: 'UnregisterWorker';
+    readonly workerId: string;
+}
+export interface ListWorkersCommand extends BaseCommand {
+    readonly cmd: 'ListWorkers';
+}

package/dist/types/src/domain/types/cron.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Cron job domain types
+ */
+/** Deduplication config for cron-spawned jobs */
+export interface CronDedup {
+    readonly ttl?: number;
+    readonly extend?: boolean;
+    readonly replace?: boolean;
+}
+/**
+ * Job options applied to every job spawned by a cron (issue #86).
+ * Mirrors the relevant subset of JobInput so retry/cleanup policy can be
+ * configured per-scheduler instead of always falling back to JOB_DEFAULTS.
+ */
+export interface CronJobOptions {
+    readonly maxAttempts?: number;
+    readonly backoff?: number | {
+        type: 'fixed' | 'exponential';
+        delay: number;
+    };
+    readonly timeout?: number;
+    readonly delay?: number;
+    readonly stallTimeout?: number;
+    readonly removeOnComplete?: boolean;
+    readonly removeOnFail?: boolean;
+}
+/** Cron job definition */
+export interface CronJob {
+    readonly name: string;
+    readonly jobName: string;
+    readonly queue: string;
+    readonly data: unknown;
+    readonly schedule: string | null;
+    readonly repeatEvery: number | null;
+    readonly priority: number;
+    /** IANA timezone for cron schedule (e.g., "Europe/Rome", "America/New_York") */
+    readonly timezone: string | null;
+    nextRun: number;
+    executions: number;
+    readonly maxLimit: number | null;
+    /** Unique key for deduplication of cron-spawned jobs */
+    readonly uniqueKey: string | null;
+    /** Deduplication options for cron-spawned jobs */
+    readonly dedup: CronDedup | null;
+    /** Skip missed runs on restart instead of executing them (default: true) */
+    readonly skipMissedOnRestart: boolean;
+    /** Skip job push if no worker is registered for the queue (default: false) */
+    readonly skipIfNoWorker: boolean;
+    /** Prevent overlapping cron jobs via automatic dedup (default: true) */
+    readonly preventOverlap: boolean;
+    /** Job options applied to each spawned job (retry/cleanup policy, etc.) */
+    readonly jobOptions: CronJobOptions | null;
+}
+/** Input for creating a cron job */
+export interface CronJobInput {
+    name: string;
+    jobName?: string;
+    queue: string;
+    data: unknown;
+    schedule?: string;
+    repeatEvery?: number;
+    priority?: number;
+    maxLimit?: number;
+    /** IANA timezone for cron schedule (e.g., "Europe/Rome", "America/New_York") */
+    timezone?: string;
+    /** Unique key for deduplication of cron-spawned jobs */
+    uniqueKey?: string;
+    /** Deduplication options for cron-spawned jobs */
+    dedup?: CronDedup;
+    /** Skip missed runs on restart instead of executing them (default: true) */
+    skipMissedOnRestart?: boolean;
+    /** Fire immediately on creation, then continue on schedule */
+    immediately?: boolean;
+    /** Skip job push if no worker is registered for the queue (default: false) */
+    skipIfNoWorker?: boolean;
+    /** Prevent overlapping cron jobs via automatic dedup (default: true) */
+    preventOverlap?: boolean;
+    /** Job options applied to each spawned job (retry/cleanup policy, etc.) */
+    jobOptions?: CronJobOptions;
+}
+/** Validate the calendar/interval timing fields before scheduler mutation. */
+export declare function assertValidCronTiming(input: {
+    readonly schedule?: string | null;
+    readonly repeatEvery?: number | null;
+}): void;
+/** Create a new cron job */
+export declare function createCronJob(input: CronJobInput, nextRun: number): CronJob;
+/** Check if cron job has reached its execution limit */
+export declare function isAtLimit(cron: CronJob): boolean;
+/** Check if cron job is due to run */
+export declare function isDue(cron: CronJob, now?: number): boolean;

package/dist/types/src/domain/types/deduplication.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Advanced Deduplication Types
+ * Supports TTL, extend, replace, and debounce strategies
+ */
+import type { JobId } from "./job.js";
+/** Deduplication strategy when a duplicate is detected */
+export type DeduplicationStrategy = 'reject' | 'extend' | 'replace';
+/**
+ * Deduplication options for job creation
+ */
+export interface DeduplicationOptions {
+    /** Unique deduplication key (maps to job.uniqueKey) */
+    id: string;
+    /** TTL in milliseconds for the unique key (optional - no expiry if not set) */
+    ttl?: number;
+    /** When true, reset TTL on duplicate instead of rejecting */
+    extend?: boolean;
+    /** When true, replace job data on duplicate instead of rejecting */
+    replace?: boolean;
+}
+/**
+ * Internal tracking entry for unique keys with TTL
+ */
+export interface UniqueKeyEntry {
+    /** The job ID that owns this unique key */
+    jobId: JobId;
+    /** When the unique key expires (null = never) */
+    expiresAt: number | null;
+    /** Original registration timestamp */
+    registeredAt: number;
+}
+/**
+ * Determine the deduplication strategy from options
+ */
+export declare function getDeduplicationStrategy(opts: DeduplicationOptions): DeduplicationStrategy;
+/**
+ * Check if a unique key entry has expired
+ */
+export declare function isUniqueKeyExpired(entry: UniqueKeyEntry, now?: number): boolean;
+/**
+ * Calculate expiration time from TTL
+ */
+export declare function calculateExpiration(ttl: number | undefined, now?: number): number | null;