@wevion/cli 1.0.2

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@wevion/cli",
+  "version": "1.0.2",
+  "description": "Wevion API command-line interface — generated from the public OpenAPI spec",
+  "type": "module",
+  "bin": {
+    "wevion": "src/index.mjs"
+  },
+  "files": [
+    "src",
+    "selftest.mjs",
+    "openapi.json"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "prepack": "node -e \"require('fs').accessSync('openapi.json')\"",
+    "test": "node selftest.mjs"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/selftest.mjs

@@ -0,0 +1,183 @@
+// Minimal runnable check for the spec->request mapping. Run: node selftest.mjs
+import assert from 'node:assert/strict'
+import { mkdtempSync, symlinkSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+import { execFileSync } from 'node:child_process'
+import { kebab, listOperations, buildRequest, configPath, resolveApiKey } from './src/index.mjs'
+
+const spec = {
+  openapi: '3.0.3',
+  security: [{ apiKeyAuth: [] }],
+  paths: {
+    '/api/v1/ad-accounts/{id}': {
+      get: {
+        operationId: 'getAdAccountById',
+        tags: ['ad-accounts'],
+        parameters: [
+          { name: 'id', in: 'path', required: true, schema: { type: 'string' } },
+          { name: 'fields', in: 'query', schema: { type: 'string' } },
+        ],
+      },
+    },
+    '/api/v1/search': {
+      get: {
+        operationId: 'searchThings',
+        tags: ['search'],
+        parameters: [
+          { name: 'q', in: 'query', required: true, schema: { type: 'string' } },
+          { name: 'ids', in: 'query', schema: { type: 'array', items: { type: 'string' } } },
+          { name: 'x-test-header', in: 'header', required: true, schema: { type: 'string' } },
+        ],
+      },
+    },
+    '/api/v1/campaigns': {
+      post: {
+        operationId: 'createCampaign',
+        tags: ['campaigns'],
+        requestBody: {
+          content: {
+            'application/json': {
+              schema: {
+                type: 'object',
+                properties: {
+                  name: { type: 'string' },
+                  budget: { type: 'number' },
+                  enabled: { type: 'boolean' },
+                  labels: { type: 'array', items: { type: 'string' } },
+                  settings: { type: 'object' },
+                },
+                required: ['name'],
+              },
+            },
+          },
+        },
+      },
+    },
+    '/api/v1/sessions/{id}/messages': {
+      post: {
+        operationId: 'createSessionMessage',
+        tags: ['chat'],
+        parameters: [{ name: 'id', in: 'path', required: true, schema: { type: 'string' } }],
+        requestBody: {
+          content: {
+            'application/json': {
+              schema: {
+                type: 'object',
+                properties: { id: { type: 'string' }, content: { type: 'string' } },
+                required: ['id', 'content'],
+              },
+            },
+          },
+        },
+      },
+    },
+    '/api/v1/uploads': {
+      post: {
+        operationId: 'uploadFile',
+        tags: ['uploads'],
+        requestBody: {
+          content: {
+            'multipart/form-data': {
+              schema: { type: 'object', properties: { file: { type: 'string', format: 'binary' } } },
+            },
+          },
+        },
+      },
+    },
+  },
+}
+
+assert.equal(kebab('getAdAccountById'), 'get-ad-account-by-id')
+
+const ops = listOperations(spec)
+assert.equal(ops.size, 5)
+
+// path + query mapping
+const get = buildRequest(ops.get('get-ad-account-by-id'), { id: 'act_9', fields: 'name,status' }, 'https://api.wevion.ai')
+assert.equal(get.method, 'GET')
+assert.equal(get.url, 'https://api.wevion.ai/api/v1/ad-accounts/act_9?fields=name%2Cstatus')
+assert.equal(get.body, undefined)
+assert.deepEqual(get.headers, {})
+
+// missing path param throws
+assert.throws(() => buildRequest(ops.get('get-ad-account-by-id'), {}, 'x'), /missing required path param --id/)
+
+// required query/header and query array mapping
+assert.throws(() => buildRequest(ops.get('search-things'), { q: 'abc' }, 'https://api.wevion.ai'), /missing required header param --x-test-header/)
+const search = buildRequest(
+  ops.get('search-things'),
+  { q: 'abc', ids: ['act_1', 'act_2,act_3'], 'x-test-header': 'secret' },
+  'https://api.wevion.ai',
+)
+assert.equal(search.url, 'https://api.wevion.ai/api/v1/search?q=abc&ids=act_1&ids=act_2&ids=act_3')
+assert.deepEqual(search.headers, { 'x-test-header': 'secret' })
+
+// body assembly from flags with schema-aware coercion
+const post = buildRequest(
+  ops.get('create-campaign'),
+  {
+    name: 'Q3',
+    budget: '100.5',
+    enabled: 'false',
+    labels: '["launch","q3"]',
+    settings: '{"daily":true}',
+  },
+  'https://api.wevion.ai/',
+)
+assert.equal(post.method, 'POST')
+assert.equal(post.url, 'https://api.wevion.ai/api/v1/campaigns')
+assert.deepEqual(JSON.parse(post.body), {
+  name: 'Q3',
+  budget: 100.5,
+  enabled: false,
+  labels: ['launch', 'q3'],
+  settings: { daily: true },
+})
+assert.throws(() => buildRequest(ops.get('create-campaign'), { budget: '100' }, 'x'), /missing required body field --name/)
+
+// raw --json overrides body but is still parsed for top-level required fields
+const raw = buildRequest(ops.get('create-campaign'), { json: '{"name":"raw"}' }, 'x')
+assert.equal(raw.body, '{"name":"raw"}')
+assert.throws(() => buildRequest(ops.get('create-campaign'), { json: '{"budget":10}' }, 'x'), /missing required body field --name/)
+
+// body fields that collide with path/query/header flags are exposed as --body-*
+const message = buildRequest(
+  ops.get('create-session-message'),
+  { id: 'sess_1', 'body-id': 'msg_1', content: 'ciao' },
+  'https://api.wevion.ai',
+)
+assert.equal(message.url, 'https://api.wevion.ai/api/v1/sessions/sess_1/messages')
+assert.deepEqual(JSON.parse(message.body), { id: 'msg_1', content: 'ciao' })
+
+// unsupported request body media types fail before fetch
+assert.throws(() => buildRequest(ops.get('upload-file'), {}, 'x'), /request body media type is not supported/)
+
+// config path honours XDG_CONFIG_HOME, falls back to ~/.config
+assert.equal(configPath({ XDG_CONFIG_HOME: '/x' }), '/x/wevion/config.json')
+assert.equal(configPath({ HOME: '/home/u' }), '/home/u/.config/wevion/config.json')
+assert.equal(configPath({ APPDATA: 'C:\\Users\\u\\AppData\\Roaming' }, 'win32'), 'C:\\Users\\u\\AppData\\Roaming/Wevion/config.json')
+
+// api key precedence: env > config
+assert.equal(resolveApiKey({ WEVION_API_KEY: 'env' }, { apiKey: 'cfg' }), 'env')
+assert.equal(resolveApiKey({}, { apiKey: 'cfg' }), 'cfg')
+assert.equal(resolveApiKey({}, {}), null)
+
+// bundled snapshot must exist and keep list/help offline.
+const bundled = JSON.parse(await readFile(new URL('./openapi.json', import.meta.url), 'utf8'))
+assert.match(bundled.openapi, /^3\./)
+assert.ok(Object.keys(bundled.paths || {}).length > 0)
+const knownCommand = listOperations(bundled).keys().next().value
+assert.ok(knownCommand)
+
+const tmp = mkdtempSync(join(tmpdir(), 'wevion-cli-'))
+const symlink = join(tmp, 'wevion')
+symlinkSync(new URL('./src/index.mjs', import.meta.url), symlink)
+const help = execFileSync(process.execPath, [symlink, 'help', knownCommand, '--base-url=http://127.0.0.1:9'], {
+  encoding: 'utf8',
+  env: { ...process.env, WEVION_API_KEY: '' },
+})
+assert.match(help, /Flags:/)
+
+console.log('ok')