@www.hyperlinks.space/program-kit 1.2.91881 → 7.8.3

package/.eas/workflows/create-development-builds.yml

@@ -0,0 +1,21 @@
+name: Create development builds
+
+jobs:
+  android_development_build:
+    name: Build Android
+    type: build
+    params:
+      platform: android
+      profile: development
+  ios_device_development_build:
+    name: Build iOS device
+    type: build
+    params:
+      platform: ios
+      profile: development
+  ios_simulator_development_build:
+    name: Build iOS simulator
+    type: build
+    params:
+      platform: ios
+      profile: development-simulator

package/.eas/workflows/create-draft.yml

@@ -0,0 +1,15 @@
+name: Create draft
+
+on:
+  push:
+    branches: ['*']
+
+jobs:
+  publish_preview_update:
+    name: Publish preview update
+    type: update
+    params:
+      branch: ${{ github.ref_name || 'test' }}
+  deploy_website:
+    name: Deploy website
+    type: deploy

package/.eas/workflows/deploy-to-production.yml

@@ -0,0 +1,68 @@
+name: Deploy to production
+
+on:
+  push:
+    branches: ['main']
+
+jobs:
+  fingerprint:
+    name: Fingerprint
+    type: fingerprint
+  get_android_build:
+    name: Check for existing android build
+    needs: [fingerprint]
+    type: get-build
+    params:
+      fingerprint_hash: ${{ needs.fingerprint.outputs.android_fingerprint_hash }}
+      profile: production
+  get_ios_build:
+    name: Check for existing ios build
+    needs: [fingerprint]
+    type: get-build
+    params:
+      fingerprint_hash: ${{ needs.fingerprint.outputs.ios_fingerprint_hash }}
+      profile: production
+  build_android:
+    name: Build Android
+    needs: [get_android_build]
+    if: ${{ !needs.get_android_build.outputs.build_id }}
+    type: build
+    params:
+      platform: android
+      profile: production
+  build_ios:
+    name: Build iOS
+    needs: [get_ios_build]
+    if: ${{ !needs.get_ios_build.outputs.build_id }}
+    type: build
+    params:
+      platform: ios
+      profile: production
+  submit_android_build:
+    name: Submit Android Build
+    needs: [build_android]
+    type: submit
+    params:
+      build_id: ${{ needs.build_android.outputs.build_id }}
+  submit_ios_build:
+    name: Submit iOS Build
+    needs: [build_ios]
+    type: submit
+    params:
+      build_id: ${{ needs.build_ios.outputs.build_id }}
+  publish_android_update:
+    name: Publish Android update
+    needs: [get_android_build]
+    if: ${{ needs.get_android_build.outputs.build_id }}
+    type: update
+    params:
+      branch: production
+      platform: android
+  publish_ios_update:
+    name: Publish iOS update
+    needs: [get_ios_build]
+    if: ${{ needs.get_ios_build.outputs.build_id }}
+    type: update
+    params:
+      branch: production
+      platform: ios

package/.env.example

@@ -0,0 +1,19 @@
+# Copy to .env and fill in. Used by bot (npm run bot:local) and optionally by Expo.
+# Do not commit .env.
+
+# Telegram bot (required for local bot; optional for Expo app)
+# Get token from @BotFather on Telegram
+BOT_TOKEN=1234567890:ABCdefGHIjklMNOpqrsTUVwxyz-EXAMPLE
+# Neon/Postgres connection string (from Neon dashboard)
+DATABASE_URL=postgresql://user:password@ep-xxx-xxx.region.aws.neon.tech/neondb?sslmode=require
+# OpenAI API key for /api/ai (required for AI responses). Get from https://platform.openai.com/api-keys
+OPENAI=sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+
+# Optional: base URL for calling APIs in dev (used by app and bot).
+# Example for local Vercel dev: http://localhost:3000
+# EXPO_PUBLIC_API_BASE_URL=http://localhost:3000
+
+# Optional: Swap.Coffee API key for TON token info and routing.
+# COFFEE=your-swap-coffee-api-key
+# COFFEE_BASE_URL=https://api.swap.coffee
+# COFFEE_TOKENS_BASE_URL=https://tokens.swap.coffee

package/.gitattributes

@@ -0,0 +1,48 @@
+# Contribution-safe normalization policy:
+# - Normalize all text files to LF in the repository.
+# - Keep binary files untouched (no EOL, no text filters, no corrupted diffs).
+# - Avoid noisy or garbled diffs from accidental encoding/filter changes.
+
+# Default: treat files as text and normalize line endings.
+* text=auto eol=lf
+
+# Windows scripts should keep CRLF in working trees.
+*.bat text eol=crlf
+*.cmd text eol=crlf
+*.ps1 text eol=crlf
+
+# Common binary assets: never apply text normalization/filtering.
+*.png  binary
+*.jpg  binary
+*.jpeg binary
+*.gif  binary
+*.webp binary
+*.ico  binary
+*.bmp  binary
+*.tif  binary
+*.tiff binary
+*.pdf  binary
+*.zip  binary
+*.gz   binary
+*.7z   binary
+*.tar  binary
+*.tgz  binary
+*.rar  binary
+*.jar  binary
+*.woff binary
+*.woff2 binary
+*.ttf  binary
+*.eot  binary
+*.otf  binary
+*.mp3  binary
+*.wav  binary
+*.mp4  binary
+*.mov  binary
+*.avi  binary
+*.webm binary
+
+# Git metadata and patches should always be text.
+.gitattributes text eol=lf
+.gitignore     text eol=lf
+*.patch        text eol=lf
+*.diff         text eol=lf

package/.gitignore

@@ -0,0 +1,52 @@
+# Learn more https://docs.github.com/en/get-started/getting-started-with-git/ignoring-files
+
+# dependencies
+node_modules/
+
+# Expo
+.expo/
+dist/
+web-build/
+releases/
+expo-env.d.ts
+
+# Native
+.kotlin/
+*.orig.*
+*.jks
+*.p8
+*.p12
+*.key
+*.mobileprovision
+
+# Metro
+.metro-health-check*
+
+# local reference (do not commit)
+build_ref.md
+
+# generated when mirroring CI before npm pack (see README Milestone snapshot section)
+fullREADME.md
+
+# debug
+npm-debug.*
+yarn-debug.*
+yarn-error.*
+
+# macOS
+.DS_Store
+*.pem
+
+# local env files (secrets; do not commit)
+.env
+.env*.local
+
+# typescript
+*.tsbuildinfo
+
+app-example
+
+# local scratch / temp
+.tmp/
+
+.vercel

package/.nvmrc

@@ -0,0 +1 @@
+20

package/.vercelignore

@@ -0,0 +1,6 @@
+# Never send env files to Vercel (secrets stay in dashboard only).
+# Vercel auto-ignores .env.local and .env.*.local but NOT plain .env.
+.env
+.env.local
+.env.*.local
+releases/

package/README.md

@@ -19,13 +19,13 @@ and deployed across popular platforms.
 ### npmjs (public)
 
 ```bash
-npx @www.hyperlinks.space/program-kit ./my-new-program
+npx @www.hyperlinks.space/program-kit ./new-program
 ```
 
 ### GitHub Packages
 
 ```bash
-npx @hyperlinksspace/program-kit ./my-new-program
+npx @hyperlinksspace/program-kit ./new-program
 ```
 
 If you install from GitHub Packages, configure `.npmrc` with the `@hyperlinksspace`
@@ -33,12 +33,17 @@ registry and token.
 
 ## After Scaffold
 
+Copy `npmrc.example` to `.npmrc` so installs match this repo (`legacy-peer-deps`; npm does not ship a real `.npmrc` in the tarball for security):
+
 ```bash
-cd my-new-program
+cd new-program
+cp npmrc.example .npmrc
 npm install
 npm run start
 ```
 
+If you prefer not to use a `.npmrc`, you can run **`npm install --legacy-peer-deps`** instead of the copy step.
+
 Then open the project **`fullREADME.md`** for details (env vars, bot setup, build
 and release commands).
 
@@ -49,5 +54,5 @@ and release commands).
 
 ## Notes
 
-- Published directly from the `app/` folder.
-- Package tarball is filtered to include only required project files.
+- Published from the repository root; the pack includes everything except patterns in [`.npmignore`](./.npmignore) (no `files` whitelist in `package.json`).
+- `.npmrc` cannot be published on npm; `npmrc.example` is included so you can copy it locally.

package/ai/openai.ts

@@ -0,0 +1,202 @@
+import OpenAI from "openai";
+
+export type AiMode = "chat" | "token_info";
+
+export type ThreadContext = {
+  user_telegram: string;
+  thread_id: number;
+  type: "bot" | "app";
+  telegram_update_id?: number | null;
+  /** When true, skip claim insert (e.g. same handler retrying token_info -> chat); still use history and persist assistant. */
+  skipClaim?: boolean;
+};
+
+export type AiRequestBase = {
+  input: string;
+  userId?: string;
+  context?: Record<string, unknown>;
+  /** When set, AI layer persists user/assistant and uses thread history for chat. */
+  threadContext?: ThreadContext;
+  /** Optional instructions for the model (e.g. length limit); passed to OpenAI native `instructions` field. */
+  instructions?: string;
+};
+
+export type AiResponseBase = {
+  ok: boolean;
+  provider: "openai";
+  output_text?: string;
+  error?: string;
+  mode: AiMode;
+  /** True when claim insert failed (another instance or duplicate); caller should not send. */
+  skipped?: boolean;
+  usage?: {
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    total_tokens?: number;
+  };
+  meta?: Record<string, unknown>;
+};
+
+const OPENAI = process.env.OPENAI?.trim() || "";
+
+const client = OPENAI ? new OpenAI({ apiKey: OPENAI }) : null;
+
+export async function callOpenAiChat(
+  mode: AiMode,
+  params: AiRequestBase,
+): Promise<AiResponseBase> {
+  if (!client) {
+    return {
+      ok: false,
+      provider: "openai",
+      mode,
+      error: "OPENAI env is not configured on the server.",
+    };
+  }
+
+  const trimmed = params.input?.trim();
+  if (!trimmed) {
+    return {
+      ok: false,
+      provider: "openai",
+      mode,
+      error: "input is required.",
+    };
+  }
+
+  const prefix =
+    mode === "token_info"
+      ? "You are a blockchain and token analyst. Answer clearly and briefly.\n\n"
+      : "";
+
+  try {
+    const response = await client.responses.create({
+      model: "gpt-5.2",
+      ...(params.instructions ? { instructions: params.instructions } : {}),
+      input: `${prefix}${trimmed}`,
+    });
+
+    return {
+      ok: true,
+      provider: "openai",
+      mode,
+      output_text: (response as any).output_text ?? undefined,
+      usage: (response as any).usage ?? undefined,
+    };
+  } catch (e: any) {
+    const message =
+      e?.message ?? "Failed to call OpenAI. Check OPENAI env and network.";
+    return {
+      ok: false,
+      provider: "openai",
+      mode,
+      error: message,
+    };
+  }
+}
+
+/** Call OpenAI with streaming; onDelta(textSoFar) is called for each chunk. Returns final response. */
+export async function callOpenAiChatStream(
+  mode: AiMode,
+  params: AiRequestBase,
+  onDelta: (text: string) => void | Promise<void>,
+  opts?: { isCancelled?: () => boolean; getAbortSignal?: () => Promise<boolean> },
+): Promise<AiResponseBase> {
+  if (!client) {
+    return {
+      ok: false,
+      provider: "openai",
+      mode,
+      error: "OPENAI env is not configured on the server.",
+    };
+  }
+
+  const trimmed = params.input?.trim();
+  if (!trimmed) {
+    return {
+      ok: false,
+      provider: "openai",
+      mode,
+      error: "input is required.",
+    };
+  }
+
+  const prefix =
+    mode === "token_info"
+      ? "You are a blockchain and token analyst. Answer clearly and briefly.\n\n"
+      : "";
+
+  try {
+    const stream = client.responses.stream({
+      model: "gpt-5.2",
+      ...(params.instructions ? { instructions: params.instructions } : {}),
+      input: `${prefix}${trimmed}`,
+    });
+
+    stream.on("response.output_text.delta", async (event: { snapshot?: string }) => {
+      if (opts?.isCancelled && opts.isCancelled()) {
+        try {
+          // eslint-disable-next-line @typescript-eslint/no-explicit-any
+          (stream as any)?.abort?.();
+        } catch {
+          /* ignore */
+        }
+        return;
+      }
+      if (opts?.getAbortSignal && (await opts.getAbortSignal())) {
+        try {
+          // eslint-disable-next-line @typescript-eslint/no-explicit-any
+          (stream as any)?.abort?.();
+        } catch {
+          /* ignore */
+        }
+        return;
+      }
+      const text = event?.snapshot ?? "";
+      if (text.length > 0) void Promise.resolve(onDelta(text));
+    });
+
+    const response = await stream.finalResponse();
+    const r = response as any;
+    let output_text = r.output_text;
+    if (output_text == null || String(output_text).trim() === "") {
+      const parts: string[] = [];
+      for (const item of r.output ?? []) {
+        if (item?.type === "message" && Array.isArray(item.content)) {
+          for (const content of item.content) {
+            if (content?.type === "output_text" && typeof content.text === "string") {
+              parts.push(content.text);
+            }
+          }
+        }
+      }
+      output_text = parts.join("");
+    }
+    if (output_text == null || String(output_text).trim() === "") {
+      return {
+        ok: false,
+        provider: "openai",
+        mode,
+        error: "OpenAI returned no text.",
+        usage: r.usage ?? undefined,
+      };
+    }
+    return {
+      ok: true,
+      provider: "openai",
+      mode,
+      output_text,
+      usage: r.usage ?? undefined,
+    };
+  } catch (e: any) {
+    const message =
+      (e && typeof e === "object" && "message" in e ? (e as Error).message : null) ??
+      (e != null ? String(e) : "Failed to call OpenAI. Check OPENAI env and network.");
+    return {
+      ok: false,
+      provider: "openai",
+      mode,
+      error: message,
+    };
+  }
+}