@belocal/js-sdk 0.1.0

package/.gitlab-ci.yml

@@ -0,0 +1,14 @@
+stages: [release]
+
+release:
+  stage: release
+  image: docker:27.0.3
+  services: [docker:27.0.3-dind]
+  variables:
+    DOCKER_TLS_CERTDIR: ""
+  script:
+    - ./build/run-publish
+  # rules:
+    # - if: '$CI_COMMIT_TAG'   # публикуем только по тегам
+  tags:
+    - production

package/Dockerfile

@@ -0,0 +1,46 @@
+# ---------- deps ----------
+FROM node:20-alpine AS deps
+WORKDIR /app
+COPY package.json package-lock.json ./
+RUN npm ci
+
+# ---------- build ----------
+FROM node:20-alpine AS build
+WORKDIR /app
+COPY --from=deps /app/node_modules ./node_modules
+COPY . .
+RUN npm run build
+RUN test -d dist && ls -la dist
+RUN npm pack --silent
+
+# ---------- publisher ----------
+FROM node:20-alpine AS publisher
+WORKDIR /app
+COPY --from=build /app /app
+
+ENV NPM_REGISTRY="https://registry.npmjs.org/" \
+    NPM_TAG="latest" \
+    DRY_RUN="0"
+
+CMD ["sh","-ceu", "\
+  : \"${NPM_TOKEN:?NPM_TOKEN is required}\"; \
+  echo \"• Registry: ${NPM_REGISTRY}\"; \
+  echo \"• Tag: ${NPM_TAG}\"; \
+  printf '%s\\n' \"//registry.npmjs.org/:_authToken=${NPM_TOKEN}\" > ~/.npmrc; \
+  npm config set registry \"${NPM_REGISTRY}\"; \
+  PKG_NAME=$(node -p \"require('./package.json').name\"); \
+  PKG_VER=$(node -p \"require('./package.json').version\"); \
+  ACCESS=\"\"; case \"$PKG_NAME\" in @*/*) ACCESS=\"--access public\";; esac; \
+  if [ \"${DRY_RUN}\" = \"1\" ]; then \
+    echo 'DRY_RUN=1 → публикация пропущена'; \
+    ls -1 *.tgz 2>/dev/null || true; \
+    exit 0; \
+  fi; \
+  if npm view \"$PKG_NAME@$PKG_VER\" version >/dev/null 2>&1; then \
+    echo \"• Version $PKG_NAME@$PKG_VER уже опубликована — пропускаю\"; \
+    exit 0; \
+  fi; \
+  echo \"• Publishing $PKG_NAME@$PKG_VER with tag '$NPM_TAG'...\"; \
+  npm publish --tag \"$NPM_TAG\" $ACCESS; \
+  echo \"✓ Published $PKG_NAME@$PKG_VER\" \
+"]

package/README.md

@@ -0,0 +1,7 @@
+# @belocal/js-sdk
+
+Runtime JS SDK for on-demand translation (browser + node).
+
+## Install
+```bash
+npm i @belocal/js-sdk

package/build/run-publish

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+: "${NPM_TOKEN:?NPM_TOKEN is required}"
+export NPM_TAG="${NPM_TAG:-latest}"
+export NPM_REGISTRY="${NPM_REGISTRY:-https://registry.npmjs.org/}"
+export NPM_PROVENANCE="${NPM_PROVENANCE:-true}"
+export DRY_RUN="${DRY_RUN:-0}"
+
+echo "Building publisher image..."
+docker compose build publisher
+
+echo "Running publisher..."
+docker compose run --rm \
+  -e NPM_TOKEN \
+  -e NPM_TAG \
+  -e NPM_REGISTRY \
+  -e NPM_PROVENANCE \
+  -e DRY_RUN \
+  publisher

package/docker-compose.yaml

@@ -0,0 +1,13 @@
+services:
+  publisher:
+    build:
+      context: .
+      dockerfile: Dockerfile
+      target: publisher
+    environment:
+      NPM_TOKEN: ${NPM_TOKEN}
+      NPM_TAG: ${NPM_TAG:-latest}
+      NPM_REGISTRY: ${NPM_REGISTRY:-https://registry.npmjs.org/}
+      NPM_PROVENANCE: ${NPM_PROVENANCE:-true}
+      DRY_RUN: ${DRY_RUN:-0}
+    tty: false

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@belocal/js-sdk",
+  "version": "0.1.0",
+  "description": "BeLocal runtime JS SDK for on-demand translation (browser + node)",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "build": "tsup",
+    "clean": "rimraf dist",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@gitlab.com/digitalwinddev/belocal/sdk/js.git"
+  },
+  "keywords": [],
+  "author": "BeLocal",
+  "license": "MIT",
+  "type": "module",
+  "bugs": {
+    "url": "https://gitlab.com/digitalwinddev/belocal/sdk/js/issues"
+  },
+  "homepage": "https://gitlab.com/digitalwinddev/belocal/sdk/js#readme",
+  "devDependencies": {
+    "@types/node": "^24.5.2",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2"
+  },
+  "exports": {
+    ".": {
+      "browser": "./dist/browser.mjs",
+      "node": "./dist/node.mjs",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "sideEffects": false
+}

package/src/core/client.ts

@@ -0,0 +1,14 @@
+import type { ClientOptions, KV, Lang, Transport } from './types';
+
+export class BeLocalClient {
+  private transport: Transport;
+
+  constructor(options: ClientOptions) {
+    this.transport = options.transport;
+  }
+
+  /** Переводит строку через переданный transport. Возвращает Promise<string>. */
+  async t(text: string, lang: Lang, ctx?: KV): Promise<string> {
+    return this.transport({ text, lang, ctx });
+  }
+}

package/src/core/engine.ts

@@ -0,0 +1,88 @@
+import type { BelocalEngineOptions, KV, Lang, Transport } from './types';
+import { createBrowserTransport } from '../transports/browser';
+import { createNodeTransport } from '../transports/node';
+
+export class BelocalEngine {
+  private transport: Transport;
+
+  constructor(options: BelocalEngineOptions) {
+    const {
+      apiKey,
+      baseUrl = 'https://dynamic.belocal.dev',
+      transport = 'auto',
+      timeoutMs = 10000,
+      retries = 3,
+      credentials,
+      headers = {},
+      agent
+    } = options;
+
+    const authHeaders = {
+      'Authorization': `Bearer ${apiKey}`,
+      ...headers
+    };
+
+    this.transport = this.createTransport(transport, {
+      baseUrl,
+      timeoutMs,
+      retries,
+      credentials,
+      headers: authHeaders,
+      agent
+    });
+  }
+
+  async t(text: string, lang: Lang, ctx?: KV): Promise<string> {
+    return this.transport({ text, lang, ctx });
+  }
+
+  private createTransport(
+    transportType: 'browser' | 'node' | 'auto',
+    config: {
+      baseUrl: string;
+      timeoutMs: number;
+      retries: number;
+      credentials?: RequestCredentials;
+      headers: Record<string, string>;
+      agent?: unknown;
+    }
+  ): Transport {
+    const actualTransport = transportType === 'auto' ? this.detectEnvironment() : transportType;
+
+    const path = '/v1/translate';
+
+    if (actualTransport === 'browser') {
+      return createBrowserTransport({
+        baseUrl: config.baseUrl,
+        path: path,
+        credentials: config.credentials,
+        headers: config.headers,
+        timeoutMs: config.timeoutMs,
+      });
+    } else {
+      return createNodeTransport({
+        baseUrl: config.baseUrl,
+        path: path,
+        headers: config.headers,
+        timeoutMs: config.timeoutMs,
+        agent: config.agent,
+        retries: config.retries,
+      });
+    }
+  }
+
+  /**
+   * Автоматически определяет среду выполнения
+   */
+  private detectEnvironment(): 'browser' | 'node' {
+    if (typeof window !== 'undefined' && typeof window.document !== 'undefined') {
+      return 'browser';
+    }
+    
+    if (typeof process !== 'undefined' && process.versions && process.versions.node) {
+      return 'node';
+    }
+
+    return 'node';
+  }
+}

package/src/core/types.ts

@@ -0,0 +1,19 @@
+export type Lang = string;
+export type KV = Record<string, unknown>;
+
+export type Transport = (params: { text: string; lang: Lang; ctx?: KV }) => Promise<string>;
+
+export interface ClientOptions {
+  transport: Transport;
+}
+
+export interface BelocalEngineOptions {
+  apiKey: string;
+  baseUrl?: string;
+  transport?: 'browser' | 'node' | 'auto';
+  timeoutMs?: number;
+  retries?: number;
+  credentials?: RequestCredentials;
+  headers?: Record<string, string>;
+  agent?: unknown;
+}

package/src/index.ts

@@ -0,0 +1,6 @@
+// Основной API
+export { BelocalEngine } from './core/engine';
+export type { BelocalEngineOptions } from './core/types';
+
+// Низкоуровневый API
+export type { Lang, KV } from './core/types';

package/src/transports/browser.ts

@@ -0,0 +1,41 @@
+import type { Transport } from '../core/types';
+
+export interface BrowserTransportConfig {
+  baseUrl: string;
+  path?: string;
+  credentials?: RequestCredentials;
+  headers?: Record<string, string>;
+  timeoutMs?: number;
+}
+
+export function createBrowserTransport(config: BrowserTransportConfig): Transport {
+  return async ({ text, lang, ctx }) => {
+    const url = `${config.baseUrl}${config.path}`;
+    const controller = new AbortController();
+    const timeoutId = config.timeoutMs ? setTimeout(() => controller.abort(), config.timeoutMs) : null;
+
+    try {
+      const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          ...config.headers,
+        },
+        body: JSON.stringify({ text, lang, ctx }),
+        credentials: config.credentials,
+        signal: controller.signal,
+      });
+
+      if (!response.ok) {
+        throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+      }
+
+      const result = await response.json();
+      return result.text || text;
+    } finally {
+      if (timeoutId) {
+        clearTimeout(timeoutId);
+      }
+    }
+  };
+}

package/src/transports/node.ts

@@ -0,0 +1,57 @@
+import type { Transport } from '../core/types';
+
+export interface NodeTransportConfig {
+  baseUrl: string;
+  path: string;
+  headers?: Record<string, string>;
+  timeoutMs?: number;
+  agent?: unknown;
+  retries?: number;
+}
+
+export function createNodeTransport(config: NodeTransportConfig): Transport {
+  return async ({ text, lang, ctx }) => {
+    const url = `${config.baseUrl}${config.path}`;
+    const maxRetries = config.retries || 0;
+    let attempt = 0;
+
+    while (attempt <= maxRetries) {
+      try {
+        const controller = new AbortController();
+        const timeoutId = config.timeoutMs ? setTimeout(() => controller.abort(), config.timeoutMs) : null;
+
+        try {
+          const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+              'Content-Type': 'application/json',
+              ...config.headers,
+            },
+            body: JSON.stringify({ text, lang, ctx }),
+            signal: controller.signal,
+          });
+
+          if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+          }
+
+          const result = await response.json();
+          return result.text || text;
+        } finally {
+          if (timeoutId) {
+            clearTimeout(timeoutId);
+          }
+        }
+      } catch (error) {
+        attempt++;
+        if (attempt > maxRetries) {
+          throw error;
+        }
+        // Exponential backoff
+        await new Promise(resolve => setTimeout(resolve, Math.pow(2, attempt) * 1000));
+      }
+    }
+
+    return text; // fallback
+  };
+}

package/tsconfig.base.json

@@ -0,0 +1,19 @@
+{
+    "compilerOptions": {
+      "target": "ES2020",
+      "module": "ESNext",
+      "lib": ["ES2020", "DOM"],
+      "moduleResolution": "Bundler",
+      "strict": true,
+      "declaration": true,
+      "emitDeclarationOnly": false,
+      "esModuleInterop": true,
+      "skipLibCheck": true,
+      "forceConsistentCasingInFileNames": true,
+      "resolveJsonModule": true,
+      "isolatedModules": true,
+      "baseUrl": ".",
+      "outDir": "dist",
+      "noEmit": true
+    }
+  }

package/tsconfig.json

@@ -0,0 +1,7 @@
+{
+    "extends": "./tsconfig.base.json",
+    "compilerOptions": {
+      "composite": false
+    },
+    "include": ["src"]
+}

package/tsup.config.js

@@ -0,0 +1,45 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig([
+  // Browser ESM build
+  {
+    entry: ['src/index.ts'],
+    format: ['esm'],
+    platform: 'browser',
+    dts: true,
+    sourcemap: true,
+    minify: true,
+    treeshake: true,
+    outExtension() {
+      return { js: '.mjs' };
+    },
+    outDir: 'dist',
+    target: 'es2020',
+    clean: true,
+    env: {
+      NODE_ENV: 'production'
+    },
+    define: {
+      __BUILD_TARGET__: '"browser"'
+    }
+  },
+  // Node ESM + (optional) CJS build
+  {
+    entry: ['src/index.ts'],
+    format: ['esm', 'cjs'],
+    platform: 'node',
+    dts: false, // d.ts уже сгенерены предыдущей сборкой
+    sourcemap: true,
+    minify: false,
+    treeshake: true,
+    outDir: 'dist',
+    target: 'node18',
+    clean: false,
+    env: {
+      NODE_ENV: 'production'
+    },
+    define: {
+      __BUILD_TARGET__: '"node"'
+    }
+  }
+]);