# Debian/Ubuntu
sudo apt-get install libpcsclite-dev pcscd

# Fedora/RHEL
sudo dnf install pcsc-lite-devel pcsc-lite

# PC/SCデーモンを起動
sudo systemctl start pcscd
sudo systemctl enable pcscd

# ユニットテストのビルドと実行
make

# またはzigを直接使用
zig build test

# シミュレータ統合テストの実行
zig build test -Dintegration_sim=true

# サンプルのビルド（PC/SCライブラリのインストールが必要）
zig build examples -Dlink_pcsc=true

# デフォルトビルド — std.cryptoバックエンド、OpenSSLリンクなし
zig build test

# FIPSビルド — OpenSSL FIPSプロバイダ（最初にfipsディレクトリで`make deps`を実行）
OPENSSL_CONF=/usr/local/ssl/ssl/openssl.cnf \
  zig build test -Dfips=true -Dopenssl_path=/usr/local/ssl

# 両方のモードを一度に
make test-dual

# プロダクションビルド（セキュア、環境変数は無視）
zig build

# 開発ビルド（HSM_PCSC_LIB_PATHを許可）
zig build -Dallow_pcsc_env_override=true

const std = @import("std");
const hsm = @import("hsm");

pub fn main() !void {
    var gpa = std.heap.GeneralPurposeAllocator(.{}){};
    defer _ = gpa.deinit();
    const allocator = gpa.allocator();

    // 利用可能なトークンを一覧表示
    const tokens = try hsm.listTokens(allocator, false);
    defer {
        for (tokens) |*t| t.deinit();
        allocator.free(tokens);
    }

    if (tokens.len == 0) {
        std.debug.print("トークンが見つかりません\n", .{});
        return;
    }

    // 最初のトークンを開く
    var token = try hsm.openToken(allocator, tokens[0].id, .{});
    defer token.close();

    // PINを確認
    try token.verifyPin("123456");

    // 証明書を読み取り
    const cert = try token.getCertificate(.authentication);
    defer allocator.free(cert);
    std.debug.print("証明書: {} バイト\n", .{cert.len});

    // ダイジェストに署名
    var digest: [32]u8 = undefined;
    std.crypto.hash.sha2.Sha256.hash("Hello, PIV!", &digest, .{});

    const signature = try token.sign(.authentication, .ecdsa_p256, &digest);
    defer allocator.free(signature);
    std.debug.print("署名: {} バイト\n", .{signature.len});
}

# すべてのユニットテストを実行
zig build test

# シミュレータテストを実行
zig build test -Dintegration_sim=true

# 読み取り専用テスト（証明書読み取り）
HSM_HIL=1 zig build test -Dhsm_hil=true

# PINが必要なテスト
HSM_HIL=1 HSM_PIN=123456 zig build test -Dhsm_hil=true

# 危険なテスト（書き込み操作） - 注意して使用
HSM_HIL=1 HSM_PIN=123456 HSM_DANGEROUS=1 zig build test -Dhsm_hil=true

# 継続的ファズ（手動で停止）
zig build test --fuzz -- --test-filter fuzz

# サンプルのビルド（PC/SCライブラリのインストールが必要）
zig build examples -Dlink_pcsc=true

# トークンの一覧表示
./zig-out/bin/list_tokens
./zig-out/bin/list_tokens --sim  # シミュレータを使用

# PIVで署名（PINは対話型TTYプロンプトで入力）
./zig-out/bin/piv_sign
./zig-out/bin/piv_sign --sim

# または環境変数でPINを指定（安全性は低い）
HSM_PIN=123456 ./zig-out/bin/piv_sign --sim

zig build test                  # デフォルト: -Dwith_otel=false (no-op)
zig build test -Dwith_otel=true # オプトイン: スパンが出力される

const hsm = @import("hsm");

pub fn main() !void {
    // Otel値を安定したアドレスに配置 — main()のスタックフレーム内の`var`（プロセスライフタイム）またはヒープ割り当て。
    // initヘルパーは`-Dwith_otel=true`の場合のみ存在します。無効ビルドでは、
    // hsm.observability_initは空の構造体に解決され、このブロックはno-opにコンパイルされます。
    if (comptime hsm.observability.enabled) {
        var otel = try hsm.observability_init.Otel.init(allocator, "my-service");
        defer otel.deinit();
        otel.installGlobals();
    }
    // ... mainの残り、hsm.Token.sign呼び出しも含む — それぞれが
    // サービスに紐づいた`hsm.sign`スパンを出力するようになります。
}

zig build test                                 # デフォルトフラグ = false
zig build test -Dwith_otel=true                # フラグオン
scripts/verify-consumer-noop.sh                # シンボル漏れチェック

src/
├── hsm.zig              # メインAPIと型
├── root.zig             # モジュールエントリポイント
├── apdu.zig             # APDUエンコーディング/デコーディング
├── tlv.zig              # BER-TLV解析
├── parallel.zig         # 並列操作（thread_pool）
├── pcsc/
│   └── pcsc.zig         # PC/SCトランスポート層（Linux/macOS/Windows）
├── piv/
│   └── piv.zig          # PIV実装
├── cac/
│   └── cac.zig          # CAC実装
├── yubikey/
│   └── yubikey.zig      # YubiKey検出
└── sim/
    ├── sim.zig          # シミュレータエントリポイント
    ├── transport.zig    # シミュレートされたトランスポート
    ├── piv_card.zig     # シミュレートされたPIVカード
    └── key_material.zig # 組み込みテストキー

tests/
├── integration.zig      # 基本統合テスト
├── sim_integration.zig  # シミュレータ統合テスト
└── hil_tests.zig        # ハードウェアインループテスト

examples/
├── list_tokens.zig      # トークン検出サンプル
└── piv_sign.zig         # 署名サンプル