@laioutr/cli 0.3.1 → 0.4.0

package/dist/format/detail.js

@@ -0,0 +1,18 @@
+/**
+ * Formats an object's fields as an aligned `label: value` detail block:
+ *
+ *     Deployment dep_abc123
+ *       Status:      success
+ *       Environment: production
+ *
+ * Labels are padded so every value starts in the same column. Fields whose
+ * value is `null`, `undefined`, or empty are omitted, so a caller can list
+ * every possible field inline without pre-filtering the absent ones.
+ */
+export function formatDetail(fields, options = {}) {
+    const indent = options.indent ?? '  ';
+    const present = fields.filter((field) => Boolean(field[1]));
+    const labelWidth = Math.max(0, ...present.map(([label]) => label.length));
+    const lines = present.map(([label, value]) => `${indent}${`${label}:`.padEnd(labelWidth + 2)}${value}`);
+    return options.title ? [options.title, ...lines].join('\n') : lines.join('\n');
+}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { run } from '@oclif/core';

package/dist/index.js

@@ -0,0 +1 @@
+export { run } from '@oclif/core';

package/dist/laioutr-base-command.d.ts

@@ -0,0 +1,8 @@
+import { Command } from '@oclif/core';
+export default abstract class LaioutrBaseCommand extends Command {
+    static args: {};
+    static flags: {
+        cockpitApiHost: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        cwd: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+}

package/dist/laioutr-base-command.js

@@ -0,0 +1,18 @@
+import { Command, Flags } from '@oclif/core';
+export default class LaioutrBaseCommand extends Command {
+    static args = {};
+    static flags = {
+        cockpitApiHost: Flags.string({
+            default: 'https://cockpit.laioutr.cloud',
+            description: 'cockpit api host',
+            env: 'COCKPIT_API_HOST',
+            required: true,
+        }),
+        cwd: Flags.string({
+            default: process.cwd(),
+            description: 'current working directory',
+            env: 'CWD',
+            required: true,
+        }),
+    };
+}

package/dist/project.d.ts

@@ -0,0 +1,14 @@
+export interface ProjectSlugs {
+    organizationSlug: string;
+    projectSlug: string;
+}
+/**
+ * Parses an `org/project` project identifier into its organization and project
+ * slugs.
+ *
+ * Tolerates a `/p/` path segment (e.g. a pasted `org/p/project` URL) by
+ * normalising it to a plain separator. Returns `null` when the input is not
+ * exactly two non-empty slash-separated parts, so callers decide how to report
+ * the error.
+ */
+export declare function parseProjectSlug(project: string): ProjectSlugs | null;

package/dist/project.js

@@ -0,0 +1,16 @@
+/**
+ * Parses an `org/project` project identifier into its organization and project
+ * slugs.
+ *
+ * Tolerates a `/p/` path segment (e.g. a pasted `org/p/project` URL) by
+ * normalising it to a plain separator. Returns `null` when the input is not
+ * exactly two non-empty slash-separated parts, so callers decide how to report
+ * the error.
+ */
+export function parseProjectSlug(project) {
+    const parts = project.replace('/p/', '/').split('/');
+    if (parts.length !== 2 || !parts[0] || !parts[1]) {
+        return null;
+    }
+    return { organizationSlug: parts[0], projectSlug: parts[1] };
+}

package/dist/rc/validation.d.ts

@@ -0,0 +1,8 @@
+import z from 'zod/v4';
+export declare const rcWithLaioutrMetaSchema: z.ZodObject<{
+    laioutr: z.ZodObject<{
+        projectSecretKey: z.ZodString;
+        projectSlug: z.ZodString;
+        environmentName: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;

package/dist/rc/validation.js

@@ -0,0 +1,8 @@
+import z from 'zod/v4';
+export const rcWithLaioutrMetaSchema = z.object({
+    laioutr: z.object({
+        projectSecretKey: z.string(),
+        projectSlug: z.string(),
+        environmentName: z.string(),
+    }),
+});

package/oclif.manifest.json

@@ -1,4 +1,545 @@
 {
-  "commands": {},
-  "version": "0.3.1"
+  "commands": {
+    "app:release": {
+      "aliases": [],
+      "args": {},
+      "description": "Publish an app version to the Laioutr platform.",
+      "examples": [
+        "<%= config.bin %> app release",
+        "<%= config.bin %> app release --channel testing",
+        "LAIOUTR_API_KEY=orgKey_xxx <%= config.bin %> app release"
+      ],
+      "flags": {
+        "cockpitApiHost": {
+          "description": "cockpit api host",
+          "env": "COCKPIT_API_HOST",
+          "name": "cockpitApiHost",
+          "required": true,
+          "default": "https://cockpit.laioutr.cloud",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cwd": {
+          "description": "current working directory",
+          "env": "CWD",
+          "name": "cwd",
+          "required": true,
+          "default": "/home/runner/work/laioutr/laioutr/apps/cli",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "key": {
+          "char": "k",
+          "description": "API key for authentication",
+          "env": "LAIOUTR_API_KEY",
+          "name": "key",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "channel": {
+          "char": "c",
+          "description": "Release channel (auto-detected from version if omitted)",
+          "name": "channel",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "stable",
+            "testing"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "app:release",
+      "pluginAlias": "@laioutr/cli",
+      "pluginName": "@laioutr/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "app",
+        "release.js"
+      ]
+    },
+    "deploy:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List recent deployments for a project.",
+      "examples": [
+        "<%= config.bin %> deploy list --project org/project --key orgKey_xxx",
+        "<%= config.bin %> deploy list --project org/project --key orgKey_xxx --limit 50"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "cockpitApiHost": {
+          "description": "cockpit api host",
+          "env": "COCKPIT_API_HOST",
+          "name": "cockpitApiHost",
+          "required": true,
+          "default": "https://cockpit.laioutr.cloud",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cwd": {
+          "description": "current working directory",
+          "env": "CWD",
+          "name": "cwd",
+          "required": true,
+          "default": "/home/runner/work/laioutr/laioutr/apps/cli",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "project": {
+          "char": "p",
+          "description": "Project identifier in org/project format",
+          "env": "PROJECT",
+          "name": "project",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "key": {
+          "char": "k",
+          "description": "Organization API key with project:deploy scope",
+          "env": "LAIOUTR_API_KEY",
+          "name": "key",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "limit": {
+          "description": "Maximum number of deployments to list (1-100)",
+          "name": "limit",
+          "default": 20,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "deploy:list",
+      "pluginAlias": "@laioutr/cli",
+      "pluginName": "@laioutr/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "deploy",
+        "list.js"
+      ]
+    },
+    "deploy:logs": {
+      "aliases": [],
+      "args": {},
+      "description": "Fetch and display build logs for a deployment.",
+      "examples": [
+        "<%= config.bin %> deploy logs --project org/project --key orgKey_xxx --deploymentId dep_abc123"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "cockpitApiHost": {
+          "description": "cockpit api host",
+          "env": "COCKPIT_API_HOST",
+          "name": "cockpitApiHost",
+          "required": true,
+          "default": "https://cockpit.laioutr.cloud",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cwd": {
+          "description": "current working directory",
+          "env": "CWD",
+          "name": "cwd",
+          "required": true,
+          "default": "/home/runner/work/laioutr/laioutr/apps/cli",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "project": {
+          "char": "p",
+          "description": "Project identifier in org/project format",
+          "env": "PROJECT",
+          "name": "project",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "key": {
+          "char": "k",
+          "description": "Organization API key with project:deploy scope",
+          "env": "LAIOUTR_API_KEY",
+          "name": "key",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "deploymentId": {
+          "description": "Deployment ID",
+          "name": "deploymentId",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "deploy:logs",
+      "pluginAlias": "@laioutr/cli",
+      "pluginName": "@laioutr/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "deploy",
+        "logs.js"
+      ]
+    },
+    "deploy:status": {
+      "aliases": [],
+      "args": {},
+      "description": "Show status of a deployment.",
+      "examples": [
+        "<%= config.bin %> deploy status --project org/project --key orgKey_xxx --deploymentId dep_abc123"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "cockpitApiHost": {
+          "description": "cockpit api host",
+          "env": "COCKPIT_API_HOST",
+          "name": "cockpitApiHost",
+          "required": true,
+          "default": "https://cockpit.laioutr.cloud",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cwd": {
+          "description": "current working directory",
+          "env": "CWD",
+          "name": "cwd",
+          "required": true,
+          "default": "/home/runner/work/laioutr/laioutr/apps/cli",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "project": {
+          "char": "p",
+          "description": "Project identifier in org/project format",
+          "env": "PROJECT",
+          "name": "project",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "key": {
+          "char": "k",
+          "description": "Organization API key with project:deploy scope",
+          "env": "LAIOUTR_API_KEY",
+          "name": "key",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "deploymentId": {
+          "description": "Deployment ID",
+          "name": "deploymentId",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "deploy:status",
+      "pluginAlias": "@laioutr/cli",
+      "pluginName": "@laioutr/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "deploy",
+        "status.js"
+      ]
+    },
+    "deploy:trigger": {
+      "aliases": [],
+      "args": {},
+      "description": "Trigger a project deployment.",
+      "examples": [
+        "<%= config.bin %> deploy trigger --project org/project --key orgKey_xxx",
+        "<%= config.bin %> deploy trigger --project org/project --key orgKey_xxx --no-wait",
+        "<%= config.bin %> deploy trigger --project org/project --key orgKey_xxx --logs",
+        "<%= config.bin %> deploy trigger --project org/project --key orgKey_xxx --preview my-feature"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "cockpitApiHost": {
+          "description": "cockpit api host",
+          "env": "COCKPIT_API_HOST",
+          "name": "cockpitApiHost",
+          "required": true,
+          "default": "https://cockpit.laioutr.cloud",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cwd": {
+          "description": "current working directory",
+          "env": "CWD",
+          "name": "cwd",
+          "required": true,
+          "default": "/home/runner/work/laioutr/laioutr/apps/cli",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "project": {
+          "char": "p",
+          "description": "Project identifier in org/project format",
+          "env": "PROJECT",
+          "name": "project",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "key": {
+          "char": "k",
+          "description": "Organization API key with project:deploy scope",
+          "env": "LAIOUTR_API_KEY",
+          "name": "key",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "wait": {
+          "description": "Wait for deployment to complete",
+          "name": "wait",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "logs": {
+          "description": "Stream build log output instead of spinner",
+          "name": "logs",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "preview": {
+          "description": "Create a preview deployment with optional name",
+          "name": "preview",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "deploy:trigger",
+      "pluginAlias": "@laioutr/cli",
+      "pluginName": "@laioutr/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "deploy",
+        "trigger.js"
+      ]
+    },
+    "rc:fetch": {
+      "aliases": [
+        "project:fetch-rc"
+      ],
+      "args": {
+        "fileName": {
+          "default": "laioutrrc.json",
+          "name": "fileName",
+          "required": false
+        }
+      },
+      "deprecateAliases": true,
+      "description": "Fetches the laioutrrc.json of a project from the cockpit api.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {
+        "cockpitApiHost": {
+          "description": "cockpit api host",
+          "env": "COCKPIT_API_HOST",
+          "name": "cockpitApiHost",
+          "required": true,
+          "default": "https://cockpit.laioutr.cloud",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cwd": {
+          "description": "current working directory",
+          "env": "CWD",
+          "name": "cwd",
+          "required": true,
+          "default": "/home/runner/work/laioutr/laioutr/apps/cli",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "environmentName": {
+          "char": "e",
+          "description": "environment name",
+          "env": "ENVIRONMENT_NAME",
+          "name": "environmentName",
+          "required": true,
+          "default": "main",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "projectSecret": {
+          "char": "s",
+          "description": "project secret",
+          "env": "PROJECT_SECRET",
+          "name": "projectSecret",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "project": {
+          "char": "p",
+          "description": "<organization slug>/<project slug>",
+          "env": "PROJECT",
+          "name": "project",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "rc:fetch",
+      "pluginAlias": "@laioutr/cli",
+      "pluginName": "@laioutr/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "rc",
+        "fetch.js"
+      ]
+    },
+    "rc:update": {
+      "aliases": [],
+      "args": {
+        "fileName": {
+          "default": "laioutrrc.json",
+          "name": "fileName",
+          "required": false
+        }
+      },
+      "description": "Updates an existing laioutrrc.json file with the latest from the cockpit api.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {
+        "cockpitApiHost": {
+          "description": "cockpit api host",
+          "env": "COCKPIT_API_HOST",
+          "name": "cockpitApiHost",
+          "required": true,
+          "default": "https://cockpit.laioutr.cloud",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cwd": {
+          "description": "current working directory",
+          "env": "CWD",
+          "name": "cwd",
+          "required": true,
+          "default": "/home/runner/work/laioutr/laioutr/apps/cli",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "rc:update",
+      "pluginAlias": "@laioutr/cli",
+      "pluginName": "@laioutr/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "rc",
+        "update.js"
+      ]
+    }
+  },
+  "version": "0.4.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@laioutr/cli",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Laioutr CLI",
   "repository": {
     "type": "git",
@@ -41,6 +41,7 @@
     "@oclif/core": "^4",
     "@oclif/plugin-help": "^6",
     "@oclif/plugin-plugins": "^5",
+    "@oclif/table": "^0.5.9",
     "jiti": "^2.6.1",
     "zod": "3.25.61"
   },
@@ -48,7 +49,7 @@
     "@oclif/test": "^4",
     "@types/chai": "^4",
     "@types/mocha": "^10",
-    "@types/node": "latest",
+    "@types/node": "22.15.32",
     "chai": "^4",
     "mocha": "^10",
     "oclif": "^4",
@@ -63,6 +64,7 @@
     "build": "shx rm -rf dist && tsc -b && oclif manifest && oclif readme",
     "dev": "./bin/dev.js",
     "lint": "eslint --cache --cache-location ../../.eslintcache",
+    "pretest": "tsc -b && oclif manifest",
     "test": "mocha --forbid-only \"test/**/*.test.ts\"",
     "posttest": "pnpm run lint",
     "version": "oclif readme && git add README.md"