@idosgames/core 0.1.0

package/dist/platform/index.cjs

@@ -0,0 +1 @@
+'use strict';var n=class{getString(e){if(typeof localStorage>"u")return null;try{return localStorage.getItem(e)}catch{return null}}setString(e,t){if(!(typeof localStorage>"u"))try{localStorage.setItem(e,t);}catch{}}remove(e){if(!(typeof localStorage>"u"))try{localStorage.removeItem(e);}catch{}}},o=class{map=new Map;getString(e){return this.map.get(e)??null}setString(e,t){this.map.set(e,t);}remove(e){this.map.delete(e);}};function r(){return globalThis.Telegram?.WebApp??null}function l(){return crypto.randomUUID()}var s="idos_device_id",i=class{storage;constructor(e=new n){this.storage=e;}getPlatform(){return r()?.platform??"Web"}getFullURL(){return typeof location<"u"?location.href:""}getStartParameter(){let e=r()?.initDataUnsafe?.start_param;return typeof e=="string"?e:null}getTelegramInitDataRaw(){let e=r()?.initData;return e&&e.length>0?e:null}getDeviceID(){let e=this.storage.getString(s);return e||(e=l(),this.storage.setString(s,e)),e}getDeviceModel(){return typeof navigator<"u"&&navigator.userAgent?navigator.userAgent:"Web"}shareLink(e){let t=r();if(t?.openTelegramLink){t.openTelegramLink(e);return}typeof window<"u"&&window.open(e,"_blank");}openInvoice(e){let t=r();if(t?.openInvoice){t.openInvoice(e);return}typeof window<"u"&&window.open(e,"_blank");}async showAd(e){let t=globalThis;typeof t.showAd=="function"&&await t.showAd(e);}async copyToClipboard(e){typeof navigator<"u"&&navigator.clipboard&&await navigator.clipboard.writeText(e);}};var p="idos_device_id",g=class{storage;constructor(e=new o){this.storage=e;}getPlatform(){return "Web"}getFullURL(){return ""}getStartParameter(){return null}getTelegramInitDataRaw(){return null}getDeviceID(){let e=this.storage.getString(p);return e||(e="noop-device",this.storage.setString(p,e)),e}getDeviceModel(){return "Noop"}shareLink(){}openInvoice(){}async showAd(){}async copyToClipboard(){}};exports.BrowserPlatformAdapter=i;exports.BrowserStorage=n;exports.MemoryStorage=o;exports.NoopPlatformAdapter=g;exports.getTelegramWebApp=r;

package/dist/platform/index.d.cts

@@ -0,0 +1,85 @@
+interface KeyValueStorage {
+    getString(key: string): string | null;
+    setString(key: string, value: string): void;
+    remove(key: string): void;
+}
+interface PlatformAdapter {
+    readonly storage: KeyValueStorage;
+    /** Platform id (e.g. Telegram `tdesktop`/`android`, or `Web`). */
+    getPlatform(): string;
+    /** Full launch URL — mirrors WebSDK.GetFullURL. */
+    getFullURL(): string;
+    /** Telegram `start_param` (referral/deeplink) if present. */
+    getStartParameter(): string | null;
+    /** Raw Telegram `initData` string for server-side auth (validated only on the server). */
+    getTelegramInitDataRaw(): string | null;
+    /** Stable per-device id (persisted) — replaces SystemInfo.deviceUniqueIdentifier. */
+    getDeviceID(): string;
+    /** Device/user-agent string — replaces SystemInfo.deviceModel. */
+    getDeviceModel(): string;
+    shareLink(url: string): void;
+    openInvoice(url: string): void;
+    showAd(blockId: string): Promise<void>;
+    copyToClipboard(text: string): Promise<void>;
+}
+
+/** localStorage-backed key/value store (replaces Unity PlayerPrefs). Fails soft. */
+declare class BrowserStorage implements KeyValueStorage {
+    getString(key: string): string | null;
+    setString(key: string, value: string): void;
+    remove(key: string): void;
+}
+/** In-memory store for tests / SSR. */
+declare class MemoryStorage implements KeyValueStorage {
+    private readonly map;
+    getString(key: string): string | null;
+    setString(key: string, value: string): void;
+    remove(key: string): void;
+}
+
+/** Browser/Telegram platform adapter. Auto-detects Telegram WebApp when present. */
+declare class BrowserPlatformAdapter implements PlatformAdapter {
+    readonly storage: KeyValueStorage;
+    constructor(storage?: KeyValueStorage);
+    getPlatform(): string;
+    getFullURL(): string;
+    getStartParameter(): string | null;
+    getTelegramInitDataRaw(): string | null;
+    getDeviceID(): string;
+    getDeviceModel(): string;
+    shareLink(url: string): void;
+    openInvoice(url: string): void;
+    showAd(blockId: string): Promise<void>;
+    copyToClipboard(text: string): Promise<void>;
+}
+
+/** No-op adapter for tests and non-browser (SSR) contexts. In-memory storage, no Telegram. */
+declare class NoopPlatformAdapter implements PlatformAdapter {
+    readonly storage: KeyValueStorage;
+    constructor(storage?: KeyValueStorage);
+    getPlatform(): string;
+    getFullURL(): string;
+    getStartParameter(): string | null;
+    getTelegramInitDataRaw(): string | null;
+    getDeviceID(): string;
+    getDeviceModel(): string;
+    shareLink(): void;
+    openInvoice(): void;
+    showAd(): Promise<void>;
+    copyToClipboard(): Promise<void>;
+}
+
+interface TelegramInitDataUnsafe {
+    start_param?: string;
+    [key: string]: unknown;
+}
+interface TelegramWebApp {
+    platform?: string;
+    initData?: string;
+    initDataUnsafe?: TelegramInitDataUnsafe;
+    openTelegramLink?: (url: string) => void;
+    openInvoice?: (url: string, callback?: (status: string) => void) => void;
+}
+declare function getTelegramWebApp(): TelegramWebApp | null;
+
+export { BrowserPlatformAdapter, BrowserStorage, type KeyValueStorage, MemoryStorage, NoopPlatformAdapter, type PlatformAdapter, type TelegramInitDataUnsafe, type TelegramWebApp, getTelegramWebApp };

package/dist/platform/index.d.ts

@@ -0,0 +1,85 @@
+interface KeyValueStorage {
+    getString(key: string): string | null;
+    setString(key: string, value: string): void;
+    remove(key: string): void;
+}
+interface PlatformAdapter {
+    readonly storage: KeyValueStorage;
+    /** Platform id (e.g. Telegram `tdesktop`/`android`, or `Web`). */
+    getPlatform(): string;
+    /** Full launch URL — mirrors WebSDK.GetFullURL. */
+    getFullURL(): string;
+    /** Telegram `start_param` (referral/deeplink) if present. */
+    getStartParameter(): string | null;
+    /** Raw Telegram `initData` string for server-side auth (validated only on the server). */
+    getTelegramInitDataRaw(): string | null;
+    /** Stable per-device id (persisted) — replaces SystemInfo.deviceUniqueIdentifier. */
+    getDeviceID(): string;
+    /** Device/user-agent string — replaces SystemInfo.deviceModel. */
+    getDeviceModel(): string;
+    shareLink(url: string): void;
+    openInvoice(url: string): void;
+    showAd(blockId: string): Promise<void>;
+    copyToClipboard(text: string): Promise<void>;
+}
+
+/** localStorage-backed key/value store (replaces Unity PlayerPrefs). Fails soft. */
+declare class BrowserStorage implements KeyValueStorage {
+    getString(key: string): string | null;
+    setString(key: string, value: string): void;
+    remove(key: string): void;
+}
+/** In-memory store for tests / SSR. */
+declare class MemoryStorage implements KeyValueStorage {
+    private readonly map;
+    getString(key: string): string | null;
+    setString(key: string, value: string): void;
+    remove(key: string): void;
+}
+
+/** Browser/Telegram platform adapter. Auto-detects Telegram WebApp when present. */
+declare class BrowserPlatformAdapter implements PlatformAdapter {
+    readonly storage: KeyValueStorage;
+    constructor(storage?: KeyValueStorage);
+    getPlatform(): string;
+    getFullURL(): string;
+    getStartParameter(): string | null;
+    getTelegramInitDataRaw(): string | null;
+    getDeviceID(): string;
+    getDeviceModel(): string;
+    shareLink(url: string): void;
+    openInvoice(url: string): void;
+    showAd(blockId: string): Promise<void>;
+    copyToClipboard(text: string): Promise<void>;
+}
+
+/** No-op adapter for tests and non-browser (SSR) contexts. In-memory storage, no Telegram. */
+declare class NoopPlatformAdapter implements PlatformAdapter {
+    readonly storage: KeyValueStorage;
+    constructor(storage?: KeyValueStorage);
+    getPlatform(): string;
+    getFullURL(): string;
+    getStartParameter(): string | null;
+    getTelegramInitDataRaw(): string | null;
+    getDeviceID(): string;
+    getDeviceModel(): string;
+    shareLink(): void;
+    openInvoice(): void;
+    showAd(): Promise<void>;
+    copyToClipboard(): Promise<void>;
+}
+
+interface TelegramInitDataUnsafe {
+    start_param?: string;
+    [key: string]: unknown;
+}
+interface TelegramWebApp {
+    platform?: string;
+    initData?: string;
+    initDataUnsafe?: TelegramInitDataUnsafe;
+    openTelegramLink?: (url: string) => void;
+    openInvoice?: (url: string, callback?: (status: string) => void) => void;
+}
+declare function getTelegramWebApp(): TelegramWebApp | null;
+
+export { BrowserPlatformAdapter, BrowserStorage, type KeyValueStorage, MemoryStorage, NoopPlatformAdapter, type PlatformAdapter, type TelegramInitDataUnsafe, type TelegramWebApp, getTelegramWebApp };

package/dist/platform/index.js

@@ -0,0 +1 @@
+export{e as BrowserPlatformAdapter,a as BrowserStorage,b as MemoryStorage,f as NoopPlatformAdapter,c as getTelegramWebApp}from'../chunk-QJVWT32O.js';

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@idosgames/core",
+  "version": "0.1.0",
+  "description": "Engine-agnostic core of the IDosGames SDK (transport, auth, cache, services, events).",
+  "type": "module",
+  "license": "MIT",
+  "author": "iDos Games",
+  "homepage": "https://github.com/iDos-Games/iDosGamesSDK_TS#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/iDos-Games/iDosGamesSDK_TS.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/iDos-Games/iDosGamesSDK_TS/issues"
+  },
+  "keywords": [
+    "idosgames",
+    "sdk",
+    "game",
+    "gamedev",
+    "telegram",
+    "web3"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./platform": {
+      "types": "./dist/platform/index.d.ts",
+      "import": "./dist/platform/index.js",
+      "require": "./dist/platform/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup && node scripts/flatten-dts.mjs",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  },
+  "dependencies": {
+    "decimal.js": "^10.4.3",
+    "zod": "^3.23.8"
+  }
+}