@sonenta/cli 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Verbumia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,115 @@
+# @verbumia/cli
+
+Command-line interface for [Verbumia](https://verbumia.ca) translation
+management. Sits next to the API and the React SDK; calls into the public
+HTTP surface using a Verbumia API key.
+
+## Install
+
+```bash
+npm install -g @verbumia/cli
+# or
+npx @verbumia/cli --help
+```
+
+## Quick start
+
+```bash
+# 1. Authenticate (the key must carry the `mcp:*` scope — see Auth below)
+verbumia login --host https://api.verbumia.dev --token vrb_live_<prefix>.<secret>
+
+# 2. Bind the current directory to a project
+verbumia init --project 069fc15d-…  --version main
+
+# 3. Import an i18next file in one shot
+verbumia import locales/fr/common.json
+```
+
+## Configuration
+
+Two files are involved:
+
+- **`verbumia.config.json`** — per-project, committed to the repo.
+  Contains the host + project_uuid + version_slug. Any command resolves
+  it by walking up from the current directory.
+
+- **`~/.verbumia/credentials`** — per-user, never committed.
+  JSON file with mode `0600` keyed by host so the same user can hold
+  credentials for multiple Verbumia deployments simultaneously
+  (e.g. cloud + local dev + self-hosted prod). The currently active
+  host is recorded as `default`.
+
+The credentials file shape:
+
+```json
+{
+  "default": "https://api.verbumia.dev",
+  "hosts": {
+    "https://api.verbumia.dev":     { "api_key": "vrb_live_…", "user_email": "…" },
+    "https://api.dev.verbumia.ca": { "api_key": "vrb_live_…" }
+  }
+}
+```
+
+## Commands
+
+All project commands talk to the metered MCP surface
+(`/v1/mcp/projects/{id}/…`) and require an API key carrying the **`mcp:*`**
+scope (see [Auth](#auth)).
+
+| Command            | Purpose                                                                 |
+|--------------------|-------------------------------------------------------------------------|
+| `login` / `logout` | Store / remove an API key for a host                                    |
+| `whoami`           | Show the active host + masked key                                       |
+| `init`             | Scaffold `verbumia.config.json` in the current dir                      |
+| `projects list`    | List projects the key can reach                                         |
+| `keys list`        | List keys (`namespace_slug/key_name`)                                   |
+| `import <files…>`  | One-shot import of i18next JSON (nested or flat) — creates keys + upserts translations |
+| `push`             | Push the whole local `locales/` tree in one import call                 |
+| `pull`             | Pull translations into `locales/<lang>/<namespace>.json`                |
+| `export`           | Export translations as i18next JSON (flat, or `--nested`)               |
+| `status`           | Diff local `locales/` against the remote project                        |
+| `releases publish` | Trigger a CDN release (publish bundles)                                 |
+| `snapshot`         | Emit a build-time `initialBundles` module for `@verbumia/react-i18next` |
+| `missing`          | List runtime-detected missing keys                                      |
+
+Mutating commands accept `--dry-run` and print a `created / updated / unchanged`
+summary.
+
+### Sync workflow
+
+```bash
+# import an i18next file (language + namespace inferred from the path)
+verbumia import locales/fr/common.json
+# …or a bare file with an explicit namespace
+verbumia import --namespace common fr.json
+
+# preview, then push the whole locales/ tree in ONE call
+verbumia push --dry-run
+verbumia push
+
+# pull remote translations back to disk; diff before committing
+verbumia pull --language fr
+verbumia status
+
+# publish to the CDN; generate a build-time SDK fallback bundle
+verbumia releases publish
+verbumia snapshot --out src/verbumia-bundles.ts
+```
+
+## Auth
+
+Every call emits `Authorization: ApiKey <prefix>.<secret>` (capital A, lowercase
+k) against the MCP surface, so the API key must carry the **`mcp:*`** scope.
+Generate one in the dashboard at *Org Settings → API Keys*. The key is supplied
+by you — via `verbumia login`, the `VERBUMIA_TOKEN` env var (handy for CI), or
+`~/.verbumia/credentials` — and is never hard-coded.
+
+> **0.2.0 migration (breaking):** the whole CLI moved from the project REST
+> surface (`/v1/projects/…`, project-scoped keys) to the MCP surface
+> (`/v1/mcp/projects/…`). Re-issue your CLI key with the `mcp:*` scope —
+> project-scoped keys now return `403`.
+
+## License
+
+MIT

package/bin/sonenta.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import("../dist/index.js").catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/bin/verbumia.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+// Deprecated alias for `sonenta` — kept functional (deprecate-not-remove).
+// Synchronous stderr write so the notice shows even on fast-exit commands
+// like --version (process.exit drops queued process.emitWarning output).
+console.error(
+  "[deprecated] `verbumia` is now `sonenta`. This alias still works but will be removed in a future major.",
+);
+import("../dist/index.js").catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }