@pikku/redis 0.12.20 → 0.12.21

package/src/redis-channel-store.ts

@@ -1,158 +0,0 @@
-import { ChannelStore } from '@pikku/core/channel'
-import type { Channel } from '@pikku/core/channel'
-import { Redis, type RedisOptions } from 'ioredis'
-
-/**
- * Redis-based implementation of ChannelStore
- *
- * Stores channel state in Redis with configurable key prefix.
- *
- * @example
- * ```typescript
- * const redis = new Redis({ host: 'localhost', port: 6379 })
- * const store = new RedisChannelStore(redis, 'myapp')
- * ```
- */
-export class RedisChannelStore extends ChannelStore {
-  private redis: Redis
-  private keyPrefix: string
-  private ownsConnection: boolean
-
-  /**
-   * @param connectionOrConfig - ioredis Redis instance or RedisOptions config
-   * @param keyPrefix - Redis key prefix (default: 'pikku')
-   */
-  constructor(
-    connectionOrConfig: Redis | RedisOptions | string,
-    keyPrefix = 'pikku'
-  ) {
-    super()
-    this.keyPrefix = keyPrefix
-
-    // Check if it's a Redis instance or config options
-    if (connectionOrConfig instanceof Redis) {
-      this.redis = connectionOrConfig
-      this.ownsConnection = false
-    } else if (typeof connectionOrConfig === 'string') {
-      // It's a connection string
-      this.redis = new Redis(connectionOrConfig)
-      this.ownsConnection = true
-    } else {
-      // It's a config object
-      this.redis = new Redis(connectionOrConfig)
-      this.ownsConnection = true
-    }
-  }
-
-  /**
-   * Initialize the store (no-op for Redis, always ready)
-   */
-  public async init(): Promise<void> {
-    // Redis doesn't require schema initialization
-    // Just verify connection works
-    await this.redis.ping()
-  }
-
-  private channelKey(channelId: string): string {
-    return `${this.keyPrefix}:channel:${channelId}`
-  }
-
-  public async addChannel({
-    channelId,
-    channelName,
-    openingData,
-  }: Channel): Promise<void> {
-    const key = this.channelKey(channelId)
-
-    await this.redis.hmset(
-      key,
-      'channelId',
-      channelId,
-      'channelName',
-      channelName,
-      'openingData',
-      JSON.stringify(openingData || {}),
-      'createdAt',
-      Date.now().toString()
-    )
-  }
-
-  public async removeChannels(channelIds: string[]): Promise<void> {
-    if (channelIds.length === 0) {
-      return
-    }
-
-    const pipeline = this.redis.pipeline()
-
-    for (const channelId of channelIds) {
-      const key = this.channelKey(channelId)
-      pipeline.del(key)
-      // Also remove from subscriptions
-      pipeline.del(`${this.keyPrefix}:subs:${channelId}`)
-    }
-
-    await pipeline.exec()
-  }
-
-  public async setPikkuUserId(
-    channelId: string,
-    pikkuUserId: string | null
-  ): Promise<void> {
-    const key = this.channelKey(channelId)
-
-    if (pikkuUserId) {
-      await this.redis.hset(key, 'pikkuUserId', pikkuUserId)
-    } else {
-      await this.redis.hdel(key, 'pikkuUserId')
-    }
-  }
-
-  public async getChannel(
-    channelId: string
-  ): Promise<Channel & { pikkuUserId?: string }> {
-    const key = this.channelKey(channelId)
-    const data = await this.redis.hgetall(key)
-
-    if (!data.channelId) {
-      throw new Error(`Channel not found: ${channelId}`)
-    }
-
-    return {
-      channelId: data.channelId!,
-      channelName: data.channelName!,
-      openingData: data.openingData ? JSON.parse(data.openingData) : {},
-      pikkuUserId: data.pikkuUserId || undefined,
-    }
-  }
-
-  public async setState(channelId: string, state: unknown): Promise<void> {
-    const key = this.channelKey(channelId)
-    await this.redis.hset(key, 'state', JSON.stringify(state ?? null))
-  }
-
-  public async getState(channelId: string): Promise<unknown | undefined> {
-    const key = this.channelKey(channelId)
-    const raw = await this.redis.hget(key, 'state')
-    if (!raw) return undefined
-    try {
-      const parsed = JSON.parse(raw)
-      return parsed ?? undefined
-    } catch {
-      return undefined
-    }
-  }
-
-  public async clearState(channelId: string): Promise<void> {
-    const key = this.channelKey(channelId)
-    await this.redis.hdel(key, 'state')
-  }
-
-  /**
-   * Close the Redis connection if owned by this store
-   */
-  public async close(): Promise<void> {
-    if (this.ownsConnection) {
-      await this.redis.quit()
-    }
-  }
-}

package/src/redis-deployment-service.ts

@@ -1,171 +0,0 @@
-import { buildRemoteHeaders } from '@pikku/core/remote'
-import type {
-  DeploymentService,
-  DeploymentServiceConfig,
-  DeploymentConfig,
-} from '@pikku/core/services'
-import type { JWTService } from '@pikku/core/services'
-import type { SecretService } from '@pikku/core/services'
-import { getAllFunctionNames } from '@pikku/core/function'
-import { Redis, type RedisOptions } from 'ioredis'
-
-export class RedisDeploymentService implements DeploymentService {
-  private redis: Redis
-  private keyPrefix: string
-  private ownsConnection: boolean
-  private heartbeatTimer?: ReturnType<typeof setInterval>
-  private deploymentConfig?: DeploymentConfig
-  private heartbeatInterval: number
-  private heartbeatTtl: number
-
-  constructor(
-    config: DeploymentServiceConfig,
-    connectionOrConfig: Redis | RedisOptions | string,
-    keyPrefix = 'pikku',
-    private jwt?: JWTService,
-    private secrets?: SecretService
-  ) {
-    this.heartbeatInterval = config.heartbeatInterval ?? 10000
-    this.heartbeatTtl = config.heartbeatTtl ?? 30000
-    this.keyPrefix = keyPrefix
-
-    if (connectionOrConfig instanceof Redis) {
-      this.redis = connectionOrConfig
-      this.ownsConnection = false
-    } else if (typeof connectionOrConfig === 'string') {
-      this.redis = new Redis(connectionOrConfig)
-      this.ownsConnection = true
-    } else {
-      this.redis = new Redis(connectionOrConfig)
-      this.ownsConnection = true
-    }
-  }
-
-  private deploymentKey(deploymentId: string): string {
-    return `${this.keyPrefix}:deployment:${deploymentId}`
-  }
-
-  private functionsIndexKey(funcName: string): string {
-    return `${this.keyPrefix}:fn:${funcName}`
-  }
-
-  public async init(): Promise<void> {}
-
-  async start(config: DeploymentConfig): Promise<void> {
-    const functions = config.functions ?? getAllFunctionNames()
-    this.deploymentConfig = { ...config, functions }
-    const ttlSeconds = Math.ceil(this.heartbeatTtl / 1000)
-    const expiryScore = Date.now() + this.heartbeatTtl
-
-    const pipeline = this.redis.pipeline()
-
-    pipeline.hset(this.deploymentKey(config.deploymentId), {
-      endpoint: config.endpoint,
-      functions: JSON.stringify(functions),
-    })
-    pipeline.expire(this.deploymentKey(config.deploymentId), ttlSeconds)
-
-    for (const fn of functions) {
-      pipeline.zadd(
-        this.functionsIndexKey(fn),
-        expiryScore,
-        config.deploymentId
-      )
-    }
-
-    await pipeline.exec()
-
-    this.heartbeatTimer = setInterval(
-      () => this.sendHeartbeat(),
-      this.heartbeatInterval
-    )
-  }
-
-  async stop(): Promise<void> {
-    if (this.heartbeatTimer) {
-      clearInterval(this.heartbeatTimer)
-      this.heartbeatTimer = undefined
-    }
-
-    if (this.deploymentConfig) {
-      const { deploymentId, functions } = this.deploymentConfig
-      const pipeline = this.redis.pipeline()
-
-      pipeline.del(this.deploymentKey(deploymentId))
-      for (const fn of functions!) {
-        pipeline.zrem(this.functionsIndexKey(fn), deploymentId)
-      }
-
-      await pipeline.exec()
-    }
-
-    if (this.ownsConnection) {
-      await this.redis.quit()
-    }
-  }
-
-  async invoke(
-    funcName: string,
-    data: unknown,
-    session?: unknown,
-    traceId?: string
-  ): Promise<unknown> {
-    const headers = await buildRemoteHeaders(
-      this.jwt,
-      this.secrets,
-      funcName,
-      session,
-      traceId
-    )
-    const indexKey = this.functionsIndexKey(funcName)
-    const now = Date.now()
-
-    await this.redis.zremrangebyscore(indexKey, '-inf', now)
-    const deploymentIds = await this.redis.zrangebyscore(indexKey, now, '+inf')
-
-    let endpoint: string | null = null
-    for (const deploymentId of deploymentIds) {
-      endpoint = await this.redis.hget(
-        this.deploymentKey(deploymentId),
-        'endpoint'
-      )
-      if (endpoint) break
-    }
-
-    if (!endpoint) {
-      throw new Error(`No deployment found for function '${funcName}'`)
-    }
-
-    const url = `${endpoint}/remote/rpc/${encodeURIComponent(funcName)}`
-    const response = await fetch(url, {
-      method: 'POST',
-      headers,
-      body: JSON.stringify({ data }),
-    })
-    if (!response.ok) {
-      throw new Error(
-        `Remote RPC call to '${funcName}' failed: ${response.status}`
-      )
-    }
-    return response.json()
-  }
-
-  private async sendHeartbeat(): Promise<void> {
-    if (!this.deploymentConfig) return
-
-    const { deploymentId, functions } = this.deploymentConfig
-    const ttlSeconds = Math.ceil(this.heartbeatTtl / 1000)
-    const expiryScore = Date.now() + this.heartbeatTtl
-
-    try {
-      const pipeline = this.redis.pipeline()
-      pipeline.expire(this.deploymentKey(deploymentId), ttlSeconds)
-      for (const fn of functions!) {
-        pipeline.zadd(this.functionsIndexKey(fn), expiryScore, deploymentId)
-      }
-      await pipeline.exec()
-    } catch {
-      // Heartbeat failed, will retry on next interval
-    }
-  }
-}

package/src/redis-eventhub-store.ts

@@ -1,104 +0,0 @@
-import type { EventHubStore } from '@pikku/core/channel'
-import { Redis, type RedisOptions } from 'ioredis'
-
-/**
- * Redis-based implementation of EventHubStore
- *
- * Manages pub/sub topic subscriptions for channels in Redis.
- *
- * @example
- * ```typescript
- * const redis = new Redis({ host: 'localhost', port: 6379 })
- * const store = new RedisEventHubStore(redis, 'myapp')
- * await store.subscribe('user.123', channelId)
- * ```
- */
-export class RedisEventHubStore implements EventHubStore {
-  private redis: Redis
-  private keyPrefix: string
-  private ownsConnection: boolean
-
-  /**
-   * @param connectionOrConfig - ioredis Redis instance or RedisOptions config
-   * @param keyPrefix - Redis key prefix (default: 'pikku')
-   */
-  constructor(
-    connectionOrConfig: Redis | RedisOptions | string,
-    keyPrefix = 'pikku'
-  ) {
-    this.keyPrefix = keyPrefix
-
-    // Check if it's a Redis instance or config options
-    if (connectionOrConfig instanceof Redis) {
-      this.redis = connectionOrConfig
-      this.ownsConnection = false
-    } else if (typeof connectionOrConfig === 'string') {
-      // It's a connection string
-      this.redis = new Redis(connectionOrConfig)
-      this.ownsConnection = true
-    } else {
-      // It's a config object
-      this.redis = new Redis(connectionOrConfig)
-      this.ownsConnection = true
-    }
-  }
-
-  /**
-   * Initialize the store (no-op for Redis, always ready)
-   */
-  public async init(): Promise<void> {
-    // Redis doesn't require schema initialization
-    await this.redis.ping()
-  }
-
-  private topicKey(topic: string): string {
-    return `${this.keyPrefix}:topic:${topic}`
-  }
-
-  private channelSubsKey(channelId: string): string {
-    return `${this.keyPrefix}:subs:${channelId}`
-  }
-
-  public async getChannelIdsForTopic(topic: string): Promise<string[]> {
-    const key = this.topicKey(topic)
-    return await this.redis.smembers(key)
-  }
-
-  public async subscribe(topic: string, channelId: string): Promise<boolean> {
-    const topicKey = this.topicKey(topic)
-    const subsKey = this.channelSubsKey(channelId)
-
-    // Add channelId to topic set and topic to channel's subscription set
-    const pipeline = this.redis.pipeline()
-    pipeline.sadd(topicKey, channelId)
-    pipeline.sadd(subsKey, topic)
-
-    await pipeline.exec()
-
-    return true
-  }
-
-  public async unsubscribe(topic: string, channelId: string): Promise<boolean> {
-    const topicKey = this.topicKey(topic)
-    const subsKey = this.channelSubsKey(channelId)
-
-    // Remove channelId from topic set and topic from channel's subscription set
-    const pipeline = this.redis.pipeline()
-    pipeline.srem(topicKey, channelId)
-    pipeline.srem(subsKey, topic)
-
-    const results = await pipeline.exec()
-
-    // Check if the channel was actually in the topic set
-    return (results![0]![1] as number) > 0
-  }
-
-  /**
-   * Close the Redis connection if owned by this store
-   */
-  public async close(): Promise<void> {
-    if (this.ownsConnection) {
-      await this.redis.quit()
-    }
-  }
-}

package/src/redis-secret-service.test.ts

@@ -1,122 +0,0 @@
-import { describe, test, before, after } from 'node:test'
-import assert from 'node:assert/strict'
-import Redis from 'ioredis-mock'
-import { defineServiceTests } from '@pikku/core/testing'
-import { RedisSecretService } from './redis-secret-service.js'
-
-describe('RedisSecretService', () => {
-  let redis: InstanceType<typeof Redis>
-
-  before(() => {
-    redis = new Redis()
-  })
-
-  after(async () => {
-    redis.disconnect()
-  })
-
-  defineServiceTests({
-    name: 'Redis',
-    services: {
-      secretService: async (config) =>
-        new RedisSecretService(redis as any, config),
-    },
-  })
-
-  test('custom keyPrefix isolates secrets', async () => {
-    const prefixRedis = new Redis()
-    const kek = 'test-key-encryption-key-32chars!'
-    const s1 = new RedisSecretService(prefixRedis as any, {
-      key: kek,
-      keyPrefix: 'app1',
-    })
-    const s2 = new RedisSecretService(prefixRedis as any, {
-      key: kek,
-      keyPrefix: 'app2',
-    })
-
-    await s1.setSecret('shared-name', { from: 'app1' })
-    await s2.setSecret('shared-name', { from: 'app2' })
-
-    const r1 = await s1.getSecret<{ from: string }>('shared-name')
-    const r2 = await s2.getSecret<{ from: string }>('shared-name')
-
-    assert.deepEqual(r1.reveal(), { from: 'app1' })
-    assert.deepEqual(r2.reveal(), { from: 'app2' })
-    prefixRedis.disconnect()
-  })
-
-  describe('decryption failures', () => {
-    const kek = 'test-key-encryption-key-32chars!'
-    const otherKek = 'a-totally-different-kek-32chars!'
-
-    test('getSecrets throws naming a secret it cannot decrypt', async () => {
-      const writer = new RedisSecretService(redis as any, { key: kek })
-      await writer.setSecret('undecryptable', { token: 'abc' })
-
-      const reader = new RedisSecretService(redis as any, { key: otherKek })
-
-      await assert.rejects(
-        () => reader.getSecrets(['undecryptable']),
-        (error: Error) => {
-          assert.equal(
-            error.message,
-            'Failed to decrypt secret "undecryptable" (key_version 1): ' +
-              'the configured KEK does not match the key it was wrapped under'
-          )
-          assert.ok(error.cause, 'the underlying crypto failure is preserved')
-          return true
-        }
-      )
-    })
-
-    test('getSecrets throws when no KEK is available for a stored key_version', async () => {
-      const writer = new RedisSecretService(redis as any, {
-        key: kek,
-        keyVersion: 7,
-      })
-      await writer.setSecret('old-version', 'value')
-
-      const reader = new RedisSecretService(redis as any, {
-        key: kek,
-        keyVersion: 8,
-      })
-
-      await assert.rejects(
-        () => reader.getSecrets(['old-version']),
-        (error: Error) => {
-          assert.equal(
-            error.message,
-            'Failed to decrypt secret "old-version" (key_version 7): ' +
-              'the configured KEK does not match the key it was wrapped under'
-          )
-          return true
-        }
-      )
-    })
-
-    test('getSecrets returns every secret when they all decrypt', async () => {
-      const service = new RedisSecretService(redis as any, { key: kek })
-      await service.setSecret('batch-a', { v: 1 })
-      await service.setSecret('batch-b', 'two')
-
-      const out = await service.getSecrets<{
-        'batch-a': { v: number }
-        'batch-b': string
-      }>(['batch-a', 'batch-b'])
-
-      assert.deepEqual(out['batch-a']!.reveal(), { v: 1 })
-      assert.equal(out['batch-b']!.reveal(), 'two')
-    })
-
-    test('getSecrets omits keys that were never stored', async () => {
-      const service = new RedisSecretService(redis as any, { key: kek })
-      await service.setSecret('present', 'here')
-
-      const out = await service.getSecrets(['present', 'never-stored'])
-
-      assert.deepEqual(Object.keys(out), ['present'])
-      assert.equal(out.present!.reveal(), 'here')
-    })
-  })
-})