<!doctype html>
<html lang="en" data-releases="../releases.json">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>p2p-swift.git — ird-p2p-swift, Swift SDK for p2p apps on the ird p2p service</title>
<style>
  :root {
    color-scheme: dark;
    --paper: #12161c; --ink: #e8edf2; --ink-soft: #9aa7b3;
    --line: #263241; --card: #182029; --code-bg: #1f2a36; --accent: #7fc4a8;
  }
  @media (prefers-color-scheme: light) {
    :root {
      color-scheme: light;
      --paper: #f8f9fa; --ink: #232a30; --ink-soft: #61707d;
      --line: #dde4ea; --card: #ffffff; --code-bg: #eef2f5; --accent: #35836a;
    }
  }
  * { margin: 0; padding: 0; box-sizing: border-box; }
  body {
    background: var(--paper); color: var(--ink);
    font: 16.5px/1.65 -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto,
      "Helvetica Neue", Arial, sans-serif;
    padding: 64px 22px 90px;
  }
  main { max-width: 660px; margin: 0 auto; }
  h1 { font-size: 40px; font-weight: 600; letter-spacing: -.4px;
    font-family: ui-monospace, SFMono-Regular, Menlo, monospace; }
  .tag { margin: 14px 0 34px; font-size: 18px; color: var(--ink-soft); }
  h2 { font-size: 20px; font-weight: 600; margin: 36px 0 10px; }
  p { margin: 10px 0; }
  a { color: var(--accent); }
  pre {
    background: var(--card); border: 1px solid var(--line); border-radius: 10px;
    padding: 13px 16px; overflow-x: auto; margin: 14px 0;
    font: 14px/1.5 ui-monospace, SFMono-Regular, Menlo, monospace;
  }
  code { font: 15px ui-monospace, SFMono-Regular, Menlo, monospace;
    background: var(--code-bg); border-radius: 5px; padding: 1px 6px; }
  pre code { background: none; padding: 0; }
  ul { padding-left: 22px; } li { margin: 6px 0; }
  footer { margin-top: 48px; padding-top: 20px; border-top: 1px solid var(--line);
    font-size: 14px; color: var(--ink-soft); }
  footer a { color: inherit; }
</style>
</head>
<body>
<main>
  <h1>p2p-swift.git</h1>
  <p class="tag"><strong>ird-p2p-swift</strong> — native Swift SDK for iOS 16+ and
  macOS 13+ apps on the <a href="https://ird.ro">ird p2p service</a>: rooms that
  find each other through the app's signaling relay, WebRTC data channels with
  TURN and the relay as fallback, end-to-end encryption, invite links, verified
  identities, and the offline mailbox. One library product,
  <code>IrdP2P</code>.</p>

  <h2>Use as a dependency</h2>
  <p>No registry — a Swift Package served straight from this domain:</p>
  <pre><code>// Package.swift
dependencies: [
    .package(url: "https://ird.cod-sursa.ro/p2p-swift.git", from: "<span data-rel="p2p-swift.version">0.2.0</span>"),
],
targets: [
    .target(name: "MyApp", dependencies: [.product(name: "IrdP2P", package: "p2p-swift")]),
]</code></pre>
  <p>The latest release is <code><span data-rel="p2p-swift.tag">v0.2.0</span></code>
  (<code><span data-rel="p2p-swift.tag_sha_short">588a219</span></code>). To pin that exact commit:</p>
  <pre><code>.package(url: "https://ird.cod-sursa.ro/p2p-swift.git", revision: "<span data-rel="p2p-swift.tag_sha">588a219d60321b5d33f3495f76c2da0ff0262fd4</span>")</code></pre>
  <p>These coordinates are filled from <a href="../releases.json">releases.json</a>,
  which scripts and agents can read directly (<code>head</code>, <code>tag</code>,
  <code>tag_sha</code> per repo).</p>

  <h2>Xcode</h2>
  <p>File ▸ Add Package Dependencies…, paste
  <code>https://ird.cod-sursa.ro/p2p-swift.git</code>, choose “Up to Next Major
  Version” from 0.2.0, and add the <code>IrdP2P</code> product to your app
  target. WebRTC arrives transitively as a binary Swift package from GitHub.</p>

  <h2>Quickstart</h2>
  <pre><code>import IrdP2P

let app = P2PApp(host: "myapp.ap2p.ro", appSalt: "myapp/v1",
                 origin: "https://myapp.example")   // an Origin the app's allowlist admits
let secret = RoomSecret.random()                     // share it in an invite link's fragment
let room = try await app.join(secret: secret)

for await event in room.events {
    switch event {
    case .peerReady(let peer, let via): print(peer, via)   // .relayed, then .direct
    case .message(let from, .json(let v)): print(from, v)
    default: break
    }
}
try await room.broadcast(json: ["text": "salut"])</code></pre>
  <p>The full guide — identity and invite links, the offline mailbox, errors,
  origins for native clients — is in the repo's <code>README.md</code>; the
  end-to-end envelope format is specified in <code>PROTOCOL.md</code>.</p>

  <h2>Clone</h2>
  <pre>git clone https://ird.cod-sursa.ro/p2p-swift.git</pre>
  <p><a href="browse/">browse the source in your browser →</a></p>

  <h2>What's inside</h2>
  <ul>
    <li><code>Sources/IrdP2PCrypto/</code> — room derivations, sealed envelopes, identities (CryptoKit only)</li>
    <li><code>Sources/IrdP2PSignaling/</code> — the service's wire contract: relay session, descriptor, TURN, mailbox</li>
    <li><code>Sources/IrdP2P/</code> — rooms, peers, WebRTC data channels, sealed mailbox, the public facade</li>
    <li><code>Examples/RoomChat/</code> — a SwiftUI room chat for iOS and macOS</li>
    <li><code>Tests/</code> — golden vectors, offline suites with fake transports, env-gated live and node-server suites</li>
    <li><code>PROTOCOL.md</code> — the SDK's end-to-end envelope specification</li>
  </ul>

  <h2>License</h2>
  <p>MIT.</p>

  <footer>Part of <a href="../">ird.cod-sursa.ro</a> — source published on IPFS,
  cloned over plain HTTP.</footer>
</main>
<script>
// Fill release coordinates from the site's releases.json (written by the
// assembler from the mirrors it publishes); the static text is the fallback.
(function () {
  var els = document.querySelectorAll('[data-rel]');
  if (!els.length || !window.fetch) return;
  fetch(document.documentElement.getAttribute('data-releases') || 'releases.json')
    .then(function (r) { return r.ok ? r.json() : null; })
    .then(function (j) {
      if (!j || !j.apps) return;
      Array.prototype.forEach.call(els, function (el) {
        var k = el.getAttribute('data-rel').split('.'), a = j.apps[k[0]];
        var v = a && a[k[1]];
        if (typeof v === 'string' && v) el.textContent = v;
      });
    })
    .catch(function () {});
})();
</script>
</body>
</html>