sloss-cli 1.0.0 → 1.1.0

package/README.md

@@ -8,6 +8,14 @@ Command-line interface for [Sloss](https://github.com/aualdrich/sloss) — a sel
 npm install -g sloss-cli
 ```
 
+Or as a project dependency:
+
+```bash
+npm install sloss-cli
+# or
+bun add sloss-cli
+```
+
 ## Quick Start
 
 ```bash
@@ -55,6 +63,33 @@ URL resolution order:
 --help            Show help
 ```
 
+## Publishing to npm
+
+Prerequisites:
+- An [npm](https://www.npmjs.com) account with publish access
+- An npm access token (Granular token with "Bypass 2FA" enabled, or an Automation classic token)
+
+```bash
+# Set your npm token
+echo "//registry.npmjs.org/:_authToken=YOUR_TOKEN" > ~/.npmrc
+
+# Bump version (patch/minor/major)
+npm version patch
+
+# Publish
+npm publish --access public
+```
+
+The package is published as [`sloss-cli`](https://www.npmjs.com/package/sloss-cli) under the `front-porch-software` npm account.
+
+### What gets published
+
+Only `bin/`, `src/`, and `README.md` are included in the npm package (controlled by `files` in `package.json`). Build scripts and other development files are excluded.
+
+## Related
+
+- **[Sloss Server](https://github.com/aualdrich/sloss)** — The distribution server that this CLI talks to
+
 ## License
 
 MIT

package/bin/sloss.js

@@ -11,6 +11,7 @@ import { listCommand } from '../src/commands/list.js';
 import { uploadCommand } from '../src/commands/upload.js';
 import { infoCommand } from '../src/commands/info.js';
 import { deleteCommand } from '../src/commands/delete.js';
+import { buildCommand } from '../src/commands/build.js';
 
 const program = new Command();
 
@@ -100,4 +101,22 @@ program
     }
   });
 
+// Build command
+program
+  .command('build')
+  .description('Queue a build via the Sloss build agent')
+  .option('--platform <platform>', 'Platform (ios or android)', 'ios')
+  .option('--profile <profile>', 'Build profile (development, preview, production)', 'development')
+  .option('--bump <type>', 'Version bump type for production (patch, minor, major)', 'patch')
+  .option('--dir <path>', 'Project directory (default: current directory)', '.')
+  .action(async (options) => {
+    try {
+      const config = resolveConfig(program.opts());
+      await buildCommand(options, config);
+    } catch (error) {
+      console.error(`Error: ${error.message}`);
+      process.exit(1);
+    }
+  });
+
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sloss-cli",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "CLI for Sloss — a self-hosted IPA/APK distribution server",
   "type": "module",
   "bin": {

package/src/client.js

@@ -61,6 +61,33 @@ export class SlossClient {
     return await this.request('DELETE', `/api/uploads/${id}`);
   }
 
+  async startBuild(tarballPath, metadata = {}) {
+    const fs = await import('fs/promises');
+    const path = await import('path');
+
+    const fileBuffer = await fs.readFile(tarballPath);
+    const fileName = path.basename(tarballPath);
+
+    const formData = new FormData();
+    const blob = new Blob([fileBuffer]);
+    formData.append('tarball', blob, fileName);
+
+    // Add build metadata
+    if (metadata.profile) formData.append('profile', metadata.profile);
+    if (metadata.platform) formData.append('platform', metadata.platform);
+    if (metadata.bump) formData.append('bump', metadata.bump);
+    if (metadata.appName) formData.append('app_name', metadata.appName);
+    if (metadata.bundleId) formData.append('bundle_id', metadata.bundleId);
+    if (metadata.version) formData.append('version', metadata.version);
+    if (metadata.buildNumber) formData.append('build_number', metadata.buildNumber);
+
+    return await this.request('POST', '/api/builds/start', formData);
+  }
+
+  async getBuild(id) {
+    return await this.request('GET', `/api/builds/${id}`);
+  }
+
   async uploadFile(filePath, platform, metadata = {}) {
     const fs = await import('fs/promises');
     const path = await import('path');

package/src/commands/build.js

@@ -0,0 +1,115 @@
+/**
+ * Build command - Tar up the project and queue a remote build via Sloss agent
+ */
+
+import { SlossClient } from '../client.js';
+import { existsSync, readFileSync } from 'fs';
+import { resolve, basename } from 'path';
+import { execSync } from 'child_process';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { formatBuild } from '../format.js';
+
+export async function buildCommand(options, config) {
+  const platform = (options.platform || 'ios').toLowerCase();
+  const profile = (options.profile || 'development').toLowerCase();
+  const bump = options.bump || 'patch';
+  const projectDir = resolve(options.dir || '.');
+
+  // Validate platform
+  if (!['ios', 'android'].includes(platform)) {
+    throw new Error('Platform must be "ios" or "android"');
+  }
+
+  // Validate profile
+  if (!['development', 'preview', 'production'].includes(profile)) {
+    throw new Error('Profile must be "development", "preview", or "production"');
+  }
+
+  // Check for .sloss.json
+  const slossConfigPath = join(projectDir, '.sloss.json');
+  if (!existsSync(slossConfigPath)) {
+    throw new Error(
+      `.sloss.json not found in ${projectDir}\n` +
+      '  Create a .sloss.json config file in your project root.\n' +
+      '  See: https://github.com/aualdrich/sloss#build-agent'
+    );
+  }
+
+  // Read config for display
+  const slossConfig = JSON.parse(readFileSync(slossConfigPath, 'utf8'));
+
+  console.log('╔══════════════════════════════════════════╗');
+  console.log('║ SLOSS BUILD                              ║');
+  console.log('╠══════════════════════════════════════════╣');
+  console.log(`║ app       : ${(slossConfig.app_name || '—').padEnd(27)} ║`);
+  console.log(`║ platform  : ${platform.padEnd(27)} ║`);
+  console.log(`║ profile   : ${profile.padEnd(27)} ║`);
+  console.log(`║ bump      : ${bump.padEnd(27)} ║`);
+  console.log(`║ server    : ${config.baseUrl.padEnd(27)} ║`);
+  console.log('╚══════════════════════════════════════════╝');
+  console.log('');
+
+  // Create tarball
+  console.log('📦 Packaging project...');
+  const tarballPath = join(tmpdir(), `sloss-build-${Date.now()}.tar.gz`);
+
+  // Use git archive if in a git repo (respects .gitignore), otherwise tar with excludes
+  let tarCmd;
+  try {
+    execSync('git rev-parse --git-dir', { cwd: projectDir, stdio: 'pipe' });
+    // git archive from the repo root, only including the project subdir if needed
+    const gitRoot = execSync('git rev-parse --show-toplevel', { cwd: projectDir, encoding: 'utf8' }).trim();
+    const relPath = projectDir.replace(gitRoot, '').replace(/^\//, '');
+
+    if (relPath) {
+      // Project is in a subdirectory — include only that dir
+      tarCmd = `cd "${gitRoot}" && git archive --format=tar HEAD -- "${relPath}" | gzip > "${tarballPath}"`;
+    } else {
+      tarCmd = `cd "${projectDir}" && git archive --format=tar.gz HEAD > "${tarballPath}"`;
+    }
+  } catch {
+    // Not a git repo — fall back to tar with common excludes
+    tarCmd = `cd "${projectDir}" && tar czf "${tarballPath}" --exclude=node_modules --exclude=.git --exclude=ios/build --exclude=android/build .`;
+  }
+
+  execSync(tarCmd, { stdio: 'pipe' });
+
+  // Get tarball size for display
+  const { statSync } = await import('fs');
+  const tarSize = statSync(tarballPath).size;
+  const sizeMB = (tarSize / (1024 * 1024)).toFixed(1);
+  console.log(`   → ${sizeMB} MB`);
+
+  // Read version info from .sloss.json's version_file
+  let version = '';
+  let buildNumber = '';
+  if (slossConfig.version_file) {
+    const versionFilePath = join(projectDir, slossConfig.version_file);
+    if (existsSync(versionFilePath)) {
+      const versionData = JSON.parse(readFileSync(versionFilePath, 'utf8'));
+      version = versionData.version || '';
+      buildNumber = versionData.buildNumber || '';
+    }
+  }
+
+  // Upload tarball to start build
+  console.log('🚀 Queuing build...');
+  const client = new SlossClient(config.baseUrl, config.apiKey);
+  const result = await client.startBuild(tarballPath, {
+    profile,
+    platform,
+    bump,
+    appName: slossConfig.app_name || '',
+    bundleId: slossConfig.bundle_id || '',
+    version,
+    buildNumber,
+  });
+
+  // Clean up tarball
+  const { unlinkSync } = await import('fs');
+  try { unlinkSync(tarballPath); } catch { /* ignore */ }
+
+  console.log('');
+  console.log(formatBuild(result, config.jsonMode));
+}

package/src/format.js

@@ -82,6 +82,22 @@ export function formatUpload(result, jsonMode = false) {
   return lines.join('\n');
 }
 
+export function formatBuild(result, jsonMode = false) {
+  if (jsonMode) {
+    return JSON.stringify(result, null, 2);
+  }
+
+  const lines = [
+    '✅ Build queued!',
+    '',
+    `Build ID:   ${result.id}`,
+    `Status:     ${result.status || 'queued'}`,
+    `Page URL:   ${result.page_url}`,
+  ];
+
+  return lines.join('\n');
+}
+
 export function formatDelete(jsonMode = false) {
   if (jsonMode) {
     return JSON.stringify({ ok: true }, null, 2);