@lionrapid/cli 0.1.0

package/dist/adapters/yaml.js

@@ -0,0 +1,51 @@
+/**
+ * YAML adapter — follows the Rails convention where the top-level key is the
+ * locale (`en:` → translations). On parse we descend into the locale root; on
+ * serialize we wrap the nested tree under the target locale. Nested keys
+ * flatten to dot notation, like the JSON adapter.
+ *
+ * (Plain locale-less YAML — e.g. some Vue-i18n setups — is best served by the
+ * JSON adapter; this adapter assumes the Rails/locale-rooted shape.)
+ */
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+import { flattenObject, unflattenEntries } from './nested.js';
+function isObject(v) {
+    return v !== null && typeof v === 'object' && !Array.isArray(v);
+}
+export class YamlAdapter {
+    format = 'yaml';
+    parse(content, options) {
+        let data;
+        try {
+            data = parseYaml(content);
+        }
+        catch (err) {
+            throw new Error(`Invalid YAML: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        if (data === null || data === undefined)
+            return [];
+        if (!isObject(data))
+            throw new Error('Expected a YAML mapping of translation keys.');
+        // Descend into the locale root: prefer the requested locale, else a single
+        // top-level mapping key (the file's own locale), else treat the doc as-is.
+        let root = data;
+        if (options?.locale && isObject(data[options.locale])) {
+            root = data[options.locale];
+        }
+        else {
+            const keys = Object.keys(data);
+            if (keys.length === 1 && isObject(data[keys[0]])) {
+                root = data[keys[0]];
+            }
+        }
+        const out = [];
+        flattenObject(root, '', out);
+        return out;
+    }
+    serialize(entries, options) {
+        const nested = unflattenEntries(entries);
+        const doc = options?.locale ? { [options.locale]: nested } : nested;
+        return stringifyYaml(doc);
+    }
+}
+//# sourceMappingURL=yaml.js.map

package/dist/adapters/yaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.js","sourceRoot":"","sources":["../../src/adapters/yaml.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AAEtE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE9D,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,OAAO,WAAW;IACb,MAAM,GAAG,MAAe,CAAC;IAElC,KAAK,CAAC,OAAe,EAAE,OAAsB;QAC3C,IAAI,IAAa,CAAC;QAClB,IAAI,CAAC;YACH,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,iBAAiB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvF,CAAC;QACD,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QACnD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAErF,2EAA2E;QAC3E,2EAA2E;QAC3E,IAAI,IAAI,GAA4B,IAAI,CAAC;QACzC,IAAI,OAAO,EAAE,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YACtD,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAA4B,CAAC;QACzD,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC,EAAE,CAAC;gBAClD,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAE,CAA4B,CAAC;YACnD,CAAC;QACH,CAAC;QAED,MAAM,GAAG,GAAuB,EAAE,CAAC;QACnC,aAAa,CAAC,IAAI,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;QAC7B,OAAO,GAAG,CAAC;IACb,CAAC;IAED,SAAS,CAAC,OAA2B,EAAE,OAA0B;QAC/D,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;QACpE,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;CACF"}

package/dist/api-client.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Typed client for the LionRapid integrations REST surface
+ * (`/api/integrations/*`). Ported from `tests/e2e/fixtures/tm-server-client.ts`
+ * — the canonical, in-repo reference for these endpoints — and trimmed to the
+ * verbs the CLI needs.
+ *
+ * Every call carries a Bearer token (project API key, `sk_eng_...` shape) and
+ * uses native `fetch`. `fetch` is injectable so the client is unit-testable
+ * without a live server.
+ */
+import type { ContentUnit } from '@lionrapid/core';
+/** A translation keyed by its *bare* name (e.g. `welcome_title` or `auto_xxx`). */
+export interface KeyedTranslation {
+    key: string;
+    value: ContentUnit;
+}
+/** Result of a namespace pull. `notModified` is true on a 304 (ETag hit). */
+export interface NamespaceBundle {
+    translations: Record<string, ContentUnit>;
+    version?: string;
+    notModified: boolean;
+    /** True on a 423 — the namespace exists but nothing is approved for delivery yet. */
+    locked: boolean;
+}
+export type FetchImpl = (input: string, init?: RequestInit) => Promise<Response>;
+export interface ApiClientOptions {
+    baseUrl: string;
+    apiKey: string;
+    /**
+     * Editor session token (`es_...`) used for workflow transitions like
+     * `mark-ready`, which the integration key is not authorized to perform.
+     */
+    editorToken?: string;
+    /** Injectable fetch (defaults to global fetch). */
+    fetchImpl?: FetchImpl;
+    /**
+     * Number of *retry* attempts for transient failures (network error, 5xx,
+     * 429). Total attempts = retries + 1. Default {@link DEFAULT_RETRIES}; 0
+     * disables retrying.
+     */
+    retries?: number;
+    /** Injectable delay (defaults to real `setTimeout`). Tests pass a no-op. */
+    sleep?: (ms: number) => Promise<void>;
+}
+/** Default number of retries for transient failures. */
+export declare const DEFAULT_RETRIES = 3;
+/**
+ * Parse a `Retry-After` header → ms, or null if absent/unparseable. Accepts the
+ * delta-seconds form (`120`) and the HTTP-date form; clamps to
+ * {@link MAX_RETRY_AFTER_MS}. `now` is injectable so the date form is testable.
+ */
+export declare function parseRetryAfter(header: string | null, now: number): number | null;
+/** Thrown when the server returns a non-2xx (and non-304) response. */
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly body: string;
+    constructor(method: string, path: string, status: number, body: string);
+    /** True for 401/403 — surfaced as an auth hint in commands. */
+    get isAuth(): boolean;
+    /** True for 5xx — a server-side problem, retryable (see A2). */
+    get isServerError(): boolean;
+}
+/**
+ * Thrown when the request never reached the server — DNS/connection/TLS failure
+ * or an abort. Distinct from {@link ApiError} (which means the server answered
+ * with a non-2xx). Carries the original failure as `cause`.
+ */
+export declare class NetworkError extends Error {
+    constructor(method: string, path: string, cause: unknown);
+}
+export declare class LionRapidApiClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly editorToken?;
+    private readonly fetchImpl;
+    private readonly retries;
+    private readonly sleep;
+    constructor(opts: ApiClientOptions);
+    /** True when this client holds an editor token and can publish (mark-ready). */
+    get canPublish(): boolean;
+    /** Credential smoke test. GET /api/integrations/editor/workflow. */
+    ping(): Promise<{
+        isPmAdmin: boolean;
+    }>;
+    /**
+     * Register source-row text for `sourceLocale`. Mirrors what the edge does on
+     * first visit when it encounters a missing key. POST /api/integrations/sync/batch.
+     */
+    syncBatch(sourceLocale: string, namespace: string, items: KeyedTranslation[]): Promise<void>;
+    /**
+     * Write target-locale translations as drafts (editor-visible, not public
+     * until mark-ready). PUT /api/integrations/targets/batch.
+     */
+    targetsBatch(targetLocale: string, namespace: string, items: KeyedTranslation[]): Promise<void>;
+    /**
+     * Publish a single target row. POST /api/integrations/targets/{key}/mark-ready.
+     * Requires an editor session token (the integration key is not authorized).
+     */
+    markReady(targetLocale: string, namespace: string, key: string): Promise<void>;
+    /**
+     * Pull all public (mark-ready) translations for a locale/namespace.
+     * GET /api/integrations/translations/{locale}/{namespace}. Sends a conditional
+     * `If-None-Match` when `etag` is provided and reports `notModified` on 304.
+     */
+    getNamespace(locale: string, namespace: string, opts?: {
+        etag?: string;
+    }): Promise<NamespaceBundle>;
+    private request;
+    /**
+     * Single choke-point for every HTTP call. Normalizes fetch *rejections*
+     * (DNS/connection/TLS/abort) into a typed {@link NetworkError}, and retries
+     * transient failures — network errors, 5xx, and 429 — with exponential
+     * backoff (honoring `Retry-After` on a 429). Non-transient responses (2xx,
+     * 3xx, and other 4xx like 401/404/423) return on the first attempt; the
+     * caller maps a non-2xx into an {@link ApiError}.
+     *
+     * Retrying writes (POST/PUT) is safe here: the integration endpoints upsert by
+     * composite key (`sync/batch`, `targets/batch`) or are idempotent
+     * (`mark-ready`), and the string `init.body` is re-sendable across attempts.
+     */
+    private doFetch;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"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"}

package/dist/api-client.js

@@ -0,0 +1,236 @@
+/**
+ * Typed client for the LionRapid integrations REST surface
+ * (`/api/integrations/*`). Ported from `tests/e2e/fixtures/tm-server-client.ts`
+ * — the canonical, in-repo reference for these endpoints — and trimmed to the
+ * verbs the CLI needs.
+ *
+ * Every call carries a Bearer token (project API key, `sk_eng_...` shape) and
+ * uses native `fetch`. `fetch` is injectable so the client is unit-testable
+ * without a live server.
+ */
+/** Default number of retries for transient failures. */
+export const DEFAULT_RETRIES = 3;
+/** Base backoff in ms; grows exponentially per attempt, capped at {@link MAX_BACKOFF_MS}. */
+const BASE_BACKOFF_MS = 300;
+const MAX_BACKOFF_MS = 10_000;
+/** Cap on an honored `Retry-After` so a hostile/misconfigured header can't hang the CLI. */
+const MAX_RETRY_AFTER_MS = 30_000;
+/** Transient statuses worth retrying: rate-limit (429) and any 5xx. */
+function isRetryableStatus(status) {
+    return status === 429 || status >= 500;
+}
+/** Exponential backoff with full jitter for attempt N (0-based). */
+function backoffMs(attempt, random) {
+    const ceiling = Math.min(BASE_BACKOFF_MS * 2 ** attempt, MAX_BACKOFF_MS);
+    return Math.round(ceiling * random()); // full jitter: [0, ceiling)
+}
+/**
+ * Parse a `Retry-After` header → ms, or null if absent/unparseable. Accepts the
+ * delta-seconds form (`120`) and the HTTP-date form; clamps to
+ * {@link MAX_RETRY_AFTER_MS}. `now` is injectable so the date form is testable.
+ */
+export function parseRetryAfter(header, now) {
+    if (!header)
+        return null;
+    const trimmed = header.trim();
+    if (/^\d+$/.test(trimmed)) {
+        return Math.min(Number(trimmed) * 1000, MAX_RETRY_AFTER_MS);
+    }
+    const when = Date.parse(trimmed);
+    if (Number.isNaN(when))
+        return null;
+    return Math.min(Math.max(0, when - now), MAX_RETRY_AFTER_MS);
+}
+/** Thrown when the server returns a non-2xx (and non-304) response. */
+export class ApiError extends Error {
+    status;
+    body;
+    constructor(method, path, status, body) {
+        super(`tm-server ${method} ${path} → ${status}: ${body.slice(0, 400)}`);
+        this.name = 'ApiError';
+        this.status = status;
+        this.body = body;
+    }
+    /** True for 401/403 — surfaced as an auth hint in commands. */
+    get isAuth() {
+        return this.status === 401 || this.status === 403;
+    }
+    /** True for 5xx — a server-side problem, retryable (see A2). */
+    get isServerError() {
+        return this.status >= 500;
+    }
+}
+/**
+ * Thrown when the request never reached the server — DNS/connection/TLS failure
+ * or an abort. Distinct from {@link ApiError} (which means the server answered
+ * with a non-2xx). Carries the original failure as `cause`.
+ */
+export class NetworkError extends Error {
+    constructor(method, path, cause) {
+        super(`tm-server ${method} ${path} → network error: ${cause instanceof Error ? cause.message : String(cause)}`, { cause });
+        this.name = 'NetworkError';
+    }
+}
+function compositeKey(locale, namespace, key) {
+    return `${locale}:${namespace}:${key}`;
+}
+export class LionRapidApiClient {
+    baseUrl;
+    apiKey;
+    editorToken;
+    fetchImpl;
+    retries;
+    sleep;
+    constructor(opts) {
+        this.baseUrl = opts.baseUrl.replace(/\/$/, '');
+        this.apiKey = opts.apiKey;
+        this.editorToken = opts.editorToken;
+        this.fetchImpl = opts.fetchImpl ?? ((input, init) => fetch(input, init));
+        this.retries = Math.max(0, opts.retries ?? DEFAULT_RETRIES);
+        this.sleep =
+            opts.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    }
+    /** True when this client holds an editor token and can publish (mark-ready). */
+    get canPublish() {
+        return typeof this.editorToken === 'string' && this.editorToken.length > 0;
+    }
+    /** Credential smoke test. GET /api/integrations/editor/workflow. */
+    async ping() {
+        const res = (await this.request('GET', '/api/integrations/editor/workflow'));
+        return { isPmAdmin: !!res?.is_pm_admin };
+    }
+    /**
+     * Register source-row text for `sourceLocale`. Mirrors what the edge does on
+     * first visit when it encounters a missing key. POST /api/integrations/sync/batch.
+     */
+    async syncBatch(sourceLocale, namespace, items) {
+        const translations = items.map((it) => ({
+            key: compositeKey(sourceLocale, namespace, it.key),
+            value: it.value,
+        }));
+        await this.request('POST', '/api/integrations/sync/batch', {
+            translations,
+            format: 'contentunit',
+        });
+    }
+    /**
+     * Write target-locale translations as drafts (editor-visible, not public
+     * until mark-ready). PUT /api/integrations/targets/batch.
+     */
+    async targetsBatch(targetLocale, namespace, items) {
+        const translations = items.map((it) => ({
+            key: compositeKey(targetLocale, namespace, it.key),
+            value: it.value,
+        }));
+        await this.request('PUT', '/api/integrations/targets/batch', {
+            translations,
+            format: 'contentunit',
+        });
+    }
+    /**
+     * Publish a single target row. POST /api/integrations/targets/{key}/mark-ready.
+     * Requires an editor session token (the integration key is not authorized).
+     */
+    async markReady(targetLocale, namespace, key) {
+        const composite = compositeKey(targetLocale, namespace, key);
+        await this.request('POST', `/api/integrations/targets/${encodeURIComponent(composite)}/mark-ready`, {}, this.editorToken ?? this.apiKey);
+    }
+    /**
+     * Pull all public (mark-ready) translations for a locale/namespace.
+     * GET /api/integrations/translations/{locale}/{namespace}. Sends a conditional
+     * `If-None-Match` when `etag` is provided and reports `notModified` on 304.
+     */
+    async getNamespace(locale, namespace, opts = {}) {
+        const path = `/api/integrations/translations/${encodeURIComponent(locale)}/${encodeURIComponent(namespace)}`;
+        const headers = {};
+        if (opts.etag)
+            headers['If-None-Match'] = `W/"${opts.etag}"`;
+        const res = await this.doFetch('GET', path, {
+            method: 'GET',
+            headers: { Authorization: `Bearer ${this.apiKey}`, ...headers },
+        });
+        if (res.status === 304) {
+            return { translations: {}, notModified: true, locked: false };
+        }
+        // 423 NAMESPACE_LOCKED — the namespace exists but nothing is approved for
+        // delivery yet. That's a normal "pending" state, not an error: report it as
+        // empty + locked so pull skips (without clobbering) and validate flags gaps.
+        if (res.status === 423) {
+            return { translations: {}, notModified: false, locked: true };
+        }
+        if (!res.ok) {
+            throw new ApiError('GET', path, res.status, await safeText(res));
+        }
+        const data = (await res.json());
+        return {
+            translations: data.translations ?? {},
+            version: data.meta?.version != null ? String(data.meta.version) : undefined,
+            notModified: false,
+            locked: false,
+        };
+    }
+    async request(method, path, body, token = this.apiKey) {
+        const res = await this.doFetch(method, path, {
+            method,
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${token}`,
+            },
+            body: body === undefined ? undefined : JSON.stringify(body),
+        });
+        if (!res.ok) {
+            throw new ApiError(method, path, res.status, await safeText(res));
+        }
+        if (res.status === 204)
+            return null;
+        const ctype = res.headers.get('content-type') ?? '';
+        if (!ctype.includes('application/json'))
+            return null;
+        return res.json();
+    }
+    /**
+     * Single choke-point for every HTTP call. Normalizes fetch *rejections*
+     * (DNS/connection/TLS/abort) into a typed {@link NetworkError}, and retries
+     * transient failures — network errors, 5xx, and 429 — with exponential
+     * backoff (honoring `Retry-After` on a 429). Non-transient responses (2xx,
+     * 3xx, and other 4xx like 401/404/423) return on the first attempt; the
+     * caller maps a non-2xx into an {@link ApiError}.
+     *
+     * Retrying writes (POST/PUT) is safe here: the integration endpoints upsert by
+     * composite key (`sync/batch`, `targets/batch`) or are idempotent
+     * (`mark-ready`), and the string `init.body` is re-sendable across attempts.
+     */
+    async doFetch(method, path, init) {
+        for (let attempt = 0;; attempt++) {
+            let res;
+            let netErr;
+            try {
+                res = await this.fetchImpl(`${this.baseUrl}${path}`, init);
+            }
+            catch (err) {
+                netErr = new NetworkError(method, path, err);
+            }
+            // A non-transient response is the answer — let the caller interpret it.
+            if (res && !isRetryableStatus(res.status))
+                return res;
+            // Exhausted retries: surface the last response (→ ApiError) or rethrow.
+            if (attempt >= this.retries) {
+                if (res)
+                    return res;
+                throw netErr;
+            }
+            const retryAfter = res?.status === 429 ? parseRetryAfter(res.headers.get('retry-after'), Date.now()) : null;
+            const delay = retryAfter ?? backoffMs(attempt, Math.random);
+            await this.sleep(delay);
+        }
+    }
+}
+async function safeText(res) {
+    try {
+        return await res.text();
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+/**
+ * @lionrapid/cli — sync translation files (iOS, Android, Flutter, JSON, YAML,
+ * PO) with the LionRapid backend.
+ *
+ * This file wires up the command surface. Each command's behaviour lives in
+ * `src/commands/*`; commands not yet implemented print a clear "not implemented
+ * yet" notice and exit non-zero so scripts never silently succeed.
+ */
+import { Command } from 'commander';
+/**
+ * Read the package version at runtime from package.json. We deliberately do
+ * NOT hardcode the version (the previous `@lionrapid/types` CLI did, and it
+ * drifted) — `../package.json` resolves correctly both from `dist/cli.js` and
+ * from `src/cli.ts` under vitest, since both sit one level below the package
+ * root.
+ */
+export declare function readVersion(): string;
+/**
+ * Build the commander program. Exported (rather than parsed inline) so tests
+ * can construct and inspect the program without executing it.
+ */
+export declare function buildProgram(): Command;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBpC;;;;;;GAMG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAMpC;AAyBD;;;GAGG;AACH,wBAAgB,YAAY,IAAI,OAAO,CA0TtC"}