npm - @hezzlgames/sdk - Versions diffs - 1.1.0 - Mend

@hezzlgames/sdk 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

package/demo/game.html ADDED Viewed

@@ -0,0 +1,380 @@
+<!doctype html>
+<html lang="ru">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
+<title>Пример игры на Hezzl SDK</title>
+<style>
+  :root{ --accent:#7d75ff; --bg:#f4f5fb; --card:#fff; --ink:#12142b; --muted:#6b7089; --line:#e6e8f2; --coin:#d98b00 }
+  :root[data-theme="dark"]{ --bg:#0e1018; --card:#171a27; --ink:#eef0fa; --muted:#9aa0bd; --line:#262a3d; --coin:#ffb020 }
+  *{box-sizing:border-box}
+  body{
+    margin:0; min-height:100vh; min-height:100dvh;
+    display:flex; flex-direction:column; gap:14px;
+    /* верхние 56 пунктов принадлежат центру — раздел 4.1 */
+    padding:calc(56px + env(safe-area-inset-top)) 16px calc(16px + env(safe-area-inset-bottom));
+    background:var(--bg); color:var(--ink);
+    font:15px/1.4 -apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,sans-serif;
+  }
+  h1{margin:0;font-size:19px;letter-spacing:-.01em}
+  h2{margin:0 0 8px;font-size:15px}
+  .card{background:var(--card);border-radius:14px;padding:14px;box-shadow:0 1px 3px rgba(16,20,50,.08);position:relative}
+  .row{display:flex;flex-wrap:wrap;gap:8px;margin-top:10px;align-items:center}
+  button{
+    font:inherit;font-weight:600;cursor:pointer;
+    padding:9px 14px;border:0;border-radius:10px;
+    background:var(--accent);color:#fff;
+  }
+  button:disabled{opacity:.5;cursor:default}
+  button.ghost{background:transparent;color:var(--ink);border:1px solid var(--line)}
+  dl{display:grid;grid-template-columns:auto 1fr;gap:4px 12px;margin:0;font-size:13.5px}
+  dt{color:var(--muted)}
+  dd{margin:0;font-variant-numeric:tabular-nums}
+  .score{font-size:34px;font-weight:700;letter-spacing:-.02em;margin:2px 0 0}
+  #log{
+    font:12px/1.45 ui-monospace,SFMono-Regular,Menlo,monospace;
+    white-space:pre-wrap; color:var(--muted);
+    max-height:190px; overflow:auto; margin:10px 0 0;
+  }
+  /* ── магазин ─────────────────────────────────────────────────────── */
+  .purse{display:flex;justify-content:space-between;align-items:center;gap:10px}
+  .coins{font-weight:700;color:var(--coin);font-variant-numeric:tabular-nums;font-size:17px}
+  .coins.bump{animation:bump .5s ease-in-out}
+  @keyframes bump{40%{transform:scale(1.25)}}
+  .bag{display:flex;gap:12px;flex-wrap:wrap;margin-top:8px;font-size:13.5px;color:var(--muted)}
+  .bag b{color:var(--ink);font-variant-numeric:tabular-nums}
+  .good{display:flex;justify-content:space-between;align-items:center;gap:10px;padding:9px 0;border-top:1px solid var(--line)}
+  .good:first-child{border-top:0}
+  .good small{display:block;color:var(--muted)}
+  .good button{white-space:nowrap}
+  .note{margin:8px 0 0;font-size:13px;color:var(--muted);min-height:1.3em}
+  .note.warn{color:#c7401d}
+  /* Прилёт награды в инвентарь: одна летящая плашка, 500 мс по дуге
+     (17.1, таблица длительностей). Не окно и не «забрать». */
+  .fly{
+    position:fixed;z-index:9;pointer-events:none;
+    padding:6px 10px;border-radius:999px;background:var(--accent);color:#fff;font-weight:700;font-size:13px;
+    transition:transform .5s cubic-bezier(.4,0,.2,1),opacity .2s .35s;
+  }
+  @media (prefers-reduced-motion:reduce){ .fly{transition:none} .coins.bump{animation:none} }
+</style>
+</head>
+<body>
+<h1>Пример игры на Hezzl SDK</h1>
+<div class="card">
+  <p class="score" id="score">0</p>
+  <div class="row">
+    <button id="tap">Заработать очки</button>
+    <button class="ghost" id="over">Закончить партию</button>
+    <button class="ghost" id="again">Заново</button>
+    <button class="ghost" id="hint" title="списание валюты центра, кейс без сервера">Подсказка · 10 <span id="hint-icon">⬡</span></button>
+  </div>
+  <p class="note" id="hint-note"></p>
+</div>
+<div class="card" id="shop" hidden>
+  <div class="purse">
+    <h2 style="margin:0">Магазин</h2>
+    <div class="row" style="margin:0">
+      <span class="coins" id="coins">—</span>
+      <button class="ghost" id="topup">Пополнить</button>
+    </div>
+  </div>
+  <div class="bag">
+    <span>бустеры <b id="bag-boosters">0</b></span>
+    <span>жизни <b id="bag-lives">3</b></span>
+    <span>подсказки <b id="bag-hints">0</b></span>
+    <span>скин <b id="bag-skin">обычный</b></span>
+  </div>
+  <div id="goods" style="margin-top:8px"></div>
+  <p class="note" id="shop-note"></p>
+</div>
+<div class="card">
+  <dl>
+    <dt>режим</dt><dd id="mode">…</dd>
+    <dt>центр умеет</dt><dd id="can">…</dd>
+    <dt>язык</dt><dd id="lang">—</dd>
+    <dt>тема</dt><dd id="theme">—</dd>
+    <dt>цвет</dt><dd id="accent">—</dd>
+    <dt>звук</dt><dd id="sound">—</dd>
+    <dt>вибрация</dt><dd id="haptics">—</dd>
+    <dt>метка</dt><dd id="ref">—</dd>
+    <dt>сохранено</dt><dd id="saved">—</dd>
+  </dl>
+  <div class="row">
+    <button class="ghost" id="share">Поделиться</button>
+    <button class="ghost" id="support">Поддержка</button>
+    <button class="ghost" id="quit">Выйти</button>
+    <button class="ghost" id="who">Кто я</button>
+  </div>
+</div>
+<pre id="log"></pre>
+<script src="../hezzl-sdk.js"></script>
+<script>
+(function () {
+  var score = 0, muted = false, haptics = true, paused = false;
+  var bag = { boosters: 0, lives: 3, hints: 0, skin: 'обычный' };
+  var el = function (id) { return document.getElementById(id); };
+  function log(line) { el('log').textContent = line + '\n' + el('log').textContent; }
+  function show(id, value) { el(id).textContent = value; }
+  /* ── что игра умеет: обработчики и есть объявление умений ────────── */
+  Hezzl.init({
+    id: 'sdk-demo',
+    version: '1.1.0',
+    modes: ['quick'],
+    orientation: 'any',
+    debug: true,
+    on: {
+      mute:      function (flag) { muted = flag; show('sound', flag ? 'выключен' : 'включён'); log('команда mute: ' + flag); },
+      haptics:   function (flag) { haptics = flag; show('haptics', flag ? 'включена' : 'выключена'); log('команда haptics: ' + flag); },
+      pause:     function () { paused = true;  log('команда pause'); },
+      resume:    function () { paused = false; log('команда resume'); },
+      restart:   function () { score = 0; render(); log('команда restart'); },
+      setlang:   function (lang) { show('lang', lang); log('команда setlang: ' + lang); },
+      settheme:  function (theme) { paint(theme); log('команда settheme: ' + theme); },
+      setaccent: function (hex) { document.documentElement.style.setProperty('--accent', '#' + hex); show('accent', '#' + hex); log('команда setaccent: ' + hex); },
+      signedin:  function (id) { log('вошёл: ' + id); refreshShop(); },
+      signedout: function () { log('вышел'); coins(0); },
+      profile:   function (p) { log('профиль: ' + (p && p.name || '—')); },
+      /* Валюта центра (7.9). balance приходит и в ответ, и сам по себе:
+         награда за задание, покупка в кошельке — счётчик обновляется
+         сразу, игра ничего не опрашивает. */
+      balance:      function (amount) { coins(amount); log('баланс: ' + amount); },
+      walletclosed: function (amount, d) { log('кошелёк закрыт, баланс ' + amount + (d.bought ? ', пополнил' : '')); }
+    }
+  });
+  function paint(theme) {
+    if (theme) document.documentElement.setAttribute('data-theme', theme);
+    else document.documentElement.removeAttribute('data-theme');
+    show('theme', theme || 'система');
+  }
+  /* ── стартовые настройки: адрес → своё → браузер ─────────────────── */
+  var s = Hezzl.settings;
+  show('lang', Hezzl.resolve('lang', '', function () {
+    return (navigator.language || 'ru').slice(0, 2) === 'en' ? 'en' : 'ru';
+  }));
+  paint(s.theme);
+  if (s.accent) { document.documentElement.style.setProperty('--accent', '#' + s.accent); show('accent', '#' + s.accent); }
+  muted = s.muted;   show('sound', muted ? 'выключен' : 'включён');
+  haptics = s.haptics; show('haptics', haptics ? 'включена' : 'выключена');
+  show('ref', s.ref || '—');
+  /* ── прогресс: через центр, а без него — своё хранилище ──────────── */
+  Hezzl.storage.get('best').then(function (best) {
+    show('saved', best === null ? 'записи нет' : 'рекорд ' + best);
+  }, function (e) {
+    /* Отказ типизирован — ветвимся по reason, а не по тексту (7.6) */
+    show('saved', 'не прочитать: ' + e.reason);
+  });
+  function render() { show('score', score); }
+  /* ── партия ──────────────────────────────────────────────────────── */
+  el('tap').onclick = function () {
+    if (paused) { log('на паузе'); return; }
+    if (score === 0) Hezzl.gameStart({ mode: 'quick' });
+    score += 10;
+    render();
+    Hezzl.score(score);                       /* лишнее SDK придержит сам */
+    if (score % 100 === 0) Hezzl.milestone('combo', score / 100);
+  };
+  el('over').onclick = function () {
+    Hezzl.gameOver({ score: score });          /* финальный счёт уходит мимо лимита */
+    Hezzl.storage.set('best', score, { sync: true, schema: 1 }).then(function () {
+      show('saved', 'рекорд ' + score);
+      log('записано');
+    }, function (e) {
+      show('saved', 'не записать: ' + e.reason);
+      log('запись отказала: ' + e.reason);
+    });
+  };
+  el('again').onclick = function () { score = 0; render(); log('заново'); };
+  el('share').onclick   = function () { Hezzl.share({ text: 'Набрал ' + score + ' очков' }); };
+  el('support').onclick = function () { Hezzl.support({ message: 'Пример обращения', state: { score: score } }); };
+  el('quit').onclick    = function () { Hezzl.exit(); };
+  el('who').onclick     = function () {
+    Hezzl.profile(['name', 'avatar']).then(function (answer) {
+      log('профиль: ' + JSON.stringify(answer.profile || null));
+    }, function (e) { log('профиль не пришёл: ' + e.reason); });
+  };
+  /* ── магазин: валюта центра ──────────────────────────────────────── */
+  function icon() { var c = Hezzl.currency(); return c && c.icon ? c.icon : '⬡'; }
+  function coins(amount) {
+    var node = el('coins');
+    node.textContent = (amount === null || amount === undefined ? '—' : amount) + ' ' + icon();
+    node.classList.remove('bump'); void node.offsetWidth; node.classList.add('bump');
+  }
+  function renderBag() {
+    show('bag-boosters', bag.boosters); show('bag-lives', bag.lives);
+    show('bag-hints', bag.hints); show('bag-skin', bag.skin);
+  }
+  /* Прилёт награды: плашка стартует от кнопки и садится на строку
+     инвентаря. Счётчик меняется в момент посадки, не раньше (17.1). */
+  function fly(from, text, toId, then) {
+    var chip = document.createElement('span');
+    chip.className = 'fly';
+    chip.textContent = text;
+    var a = from.getBoundingClientRect(), b = el(toId).getBoundingClientRect();
+    chip.style.left = a.left + 'px'; chip.style.top = a.top + 'px';
+    document.body.appendChild(chip);
+    requestAnimationFrame(function () {
+      chip.style.transform = 'translate(' + (b.left - a.left) + 'px,' + (b.top - a.top) + 'px) scale(.8)';
+      chip.style.opacity = '0';
+    });
+    setTimeout(function () { chip.remove(); then(); }, 520);
+  }
+  /* Что сказать человеку на отказ. Ветвимся по reason (7.9): текст
+     центра — не для показа. cancelled молчит: человек сам передумал. */
+  function excuse(e) {
+    if (e.reason === 'insufficient') return 'Не хватает ' + e.need + ' ' + icon();
+    if (e.reason === 'cancelled') return '';
+    if (e.reason === 'signin') return 'Войдите в центр, чтобы покупать';
+    if (e.reason === 'notfound' || e.reason === 'disabled') return 'Товара больше нет';
+    if (e.reason === 'unavailable') return 'Магазин недоступен';
+    return 'Не получилось, попробуйте ещё раз';
+  }
+  function say(id, text, warn) {
+    var node = el(id);
+    node.textContent = text;
+    node.className = 'note' + (warn && text ? ' warn' : '');
+  }
+  function grant(award, from) {
+    /* Награда — из ответа центра, а не из своих ожиданий: цену
+       и состав товара знает наш каталог, игра их не хранит. */
+    var parts = [];
+    for (var key in award) if (award.hasOwnProperty(key)) parts.push(key);
+    (function next(i) {
+      if (i >= parts.length) return;
+      var key = parts[i], value = award[key];
+      var label = key === 'boosters' ? '+' + value + ' бустер' : key === 'lives' ? '+' + value + ' жизней'
+                : key === 'skin' ? 'скин «' + value + '»' : key + ' ' + value;
+      var to = key === 'boosters' ? 'bag-boosters' : key === 'lives' ? 'bag-lives' : key === 'skin' ? 'bag-skin' : 'bag-boosters';
+      fly(from, label, to, function () {
+        if (key === 'skin') bag.skin = value;
+        else if (typeof bag[key] === 'number') bag[key] += value;
+        renderBag();
+        next(i + 1);
+      });
+    })(0);
+  }
+  /* Кейс 1 — товар из нашего каталога. Центр сам спросит подтверждение
+     и сам покажет кошелёк, если не хватает; нам остаётся ждать. */
+  function buy(good, button) {
+    button.disabled = true;
+    say('shop-note', '');
+    Hezzl.buy(good.id).then(function (done) {
+      coins(done.amount);
+      grant(done.award || {}, button);
+      log('куплено #' + done.goodId + ', выдано ' + JSON.stringify(done.award) + ', осталось ' + done.amount);
+    }, function (e) {
+      say('shop-note', excuse(e), true);
+      log('покупка #' + good.id + ' не прошла: ' + e.reason + (e.need ? ', не хватает ' + e.need : ''));
+    }).then(function () { button.disabled = false; });
+  }
+  function renderGoods(goods) {
+    var root = el('goods');
+    root.innerHTML = '';
+    goods.forEach(function (g) {
+      var row = document.createElement('div');
+      row.className = 'good';
+      var text = document.createElement('div');
+      text.innerHTML = '<b></b><small></small>';
+      text.querySelector('b').textContent = g.title;
+      text.querySelector('small').textContent = describe(g.award);
+      var button = document.createElement('button');
+      button.textContent = g.price + ' ' + icon();
+      button.onclick = function () { buy(g, button); };
+      row.appendChild(text); row.appendChild(button);
+      root.appendChild(row);
+    });
+  }
+  function describe(award) {
+    var out = [];
+    for (var k in award) if (award.hasOwnProperty(k)) out.push(k + ': ' + award[k]);
+    return out.join(', ') || '—';
+  }
+  function refreshShop() {
+    if (!Hezzl.can('balance')) return;
+    Hezzl.balance().then(function (a) {
+      coins(a.signedIn ? a.amount : null);
+      if (!a.signedIn) say('shop-note', 'Войдите, чтобы видеть баланс');
+    }, function (e) { log('баланс не пришёл: ' + e.reason); });
+    Hezzl.goods().then(function (a) { renderGoods(a.goods || []); },
+                       function (e) { log('товары не пришли: ' + e.reason); });
+  }
+  el('topup').onclick = function () {
+    Hezzl.wallet({ reason: 'Магазин' }).then(function (w) { coins(w.amount); },
+                                           function (e) { log('кошелёк не открылся: ' + e.reason); });
+  };
+  /* Кейс 2 — товар свой, цену назначает игра: подсказка за 10.
+     Списание идёт через центр, он и подтверждает. Выдаём только
+     после ответа ok, а не по нажатию. */
+  el('hint').onclick = function () {
+    var button = this;
+    if (!Hezzl.can('balance')) { say('hint-note', 'Подсказки продаются только в центре', true); return; }
+    button.disabled = true;
+    say('hint-note', '');
+    Hezzl.spend(10, { item: 'Подсказка' }).then(function (done) {
+      coins(done.amount);
+      fly(button, '+1 подсказка', 'bag-hints', function () { bag.hints++; renderBag(); });
+      log('списано ' + done.spent + ', осталось ' + done.amount);
+    }, function (e) {
+      say('hint-note', excuse(e), true);
+      log('подсказка не куплена: ' + e.reason);
+    }).then(function () { button.disabled = false; });
+  };
+  /* ── готовы принимать ввод ───────────────────────────────────────── */
+  render();
+  renderBag();
+  Hezzl.ready();
+  /* Режим известен не сразу: ждём рукопожатия или его отсутствия. */
+  var tick = setInterval(function () {
+    show('mode', Hezzl.mode());
+    if (Hezzl.mode() === 'unknown') return;
+    clearInterval(tick);
+    var can = ['share', 'support', 'exit', 'auth', 'profile', 'storage', 'balance'].filter(function (x) { return Hezzl.can(x); });
+    show('can', can.length ? can.join(', ') : '—');
+    /* Кнопки, зависящие от центра, показываем только после ack (3.8) */
+    ['share', 'support', 'quit', 'who'].forEach(function (id) {
+      el(id).style.display = can.length ? '' : 'none';
+    });
+    /* Магазин — только если у центра есть валюта. Иначе его нет вовсе:
+       кнопка «купить» без магазина за ней хуже отсутствующей. */
+    el('shop').hidden = !Hezzl.can('balance');
+    el('hint').style.display = Hezzl.can('balance') ? '' : 'none';
+    show('hint-icon', icon());
+    refreshShop();
+    log('режим: ' + Hezzl.mode());
+  }, 100);
+})();
+</script>
+</body>
+</html>

package/demo/hezzl.json ADDED Viewed

@@ -0,0 +1,18 @@
+{
+  "id": "sdk-demo",
+  "version": "1.1.0",
+  "sdk": 1,
+  "title": { "ru": "Пример игры на Hezzl SDK", "en": "Hezzl SDK sample" },
+  "entry": "game.html",
+  "modes": ["quick"],
+  "orientation": "any",
+  "supports": ["mute", "haptics", "pause", "resume", "restart", "setlang", "settheme", "setaccent"],
+  "schema": 1,
+  "offline": true,
+  "purchases": false,
+  "currency": true,
+  "profile": ["name", "avatar"],
+  "hosts": [],
+  "engine": "dom",
+  "field": "dom"
+}