packages/runtime/src/__tests__/opencode-session-header.test.ts

/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 */

import assert from 'node:assert/strict';
import { describe, test } from 'node:test';
import { OPENCODE_SESSION_HEADER, withOpenCodeSessionHeader } from '../opencode-session-header.js';

describe('OpenCode session header', () => {
  test('adds a trimmed stable session identity for OpenCode Go and Free', () => {
    assert.deepEqual(withOpenCodeSessionHeader('opencode-go', '  session-a  '), {
      [OPENCODE_SESSION_HEADER]: 'session-a',
    });
    assert.equal(withOpenCodeSessionHeader('opencode', 'session-a'), undefined);
    assert.equal(withOpenCodeSessionHeader('openai', 'session-a'), undefined);
    assert.deepEqual(withOpenCodeSessionHeader('opencode-free', '  session-a  '), {
      [OPENCODE_SESSION_HEADER]: 'session-a',
    });
  });

  test('preserves an explicitly configured header case-insensitively', () => {
    const explicitHeaders = {
      'X-OpenCode-Session': 'operator-selected-session',
      'X-Maka-Test': 'preserved',
    };

    assert.equal(
      withOpenCodeSessionHeader('opencode-go', 'automatic-session', explicitHeaders),
      explicitHeaders,
    );
    assert.equal(
      withOpenCodeSessionHeader('opencode-free', 'automatic-session', explicitHeaders),
      explicitHeaders,
    );
  });

  test('does not add an empty session identity', () => {
    const headers = { 'X-Maka-Test': 'preserved' };
    assert.equal(withOpenCodeSessionHeader('opencode-go', '   ', headers), headers);
    assert.equal(withOpenCodeSessionHeader('opencode-free', '   ', headers), headers);
    assert.equal(withOpenCodeSessionHeader('opencode-free', undefined, headers), headers);
  });
});