castle-web-cli 0.4.64 → 0.4.65

package/dist/index.js

@@ -9,7 +9,16 @@ import { init } from './init.js';
 import { connectWS, savePreviewImage, savePreviewIfNeeded, takeScreenshot } from './preview.js';
 const args = process.argv.slice(2);
 const command = args[0];
-const FLAGS_WITH_VALUES = new Set(['--port', '--out', '--host', '--kit', '--deck-id']);
+const FLAGS_WITH_VALUES = new Set([
+    '--port',
+    '--out',
+    '--host',
+    '--kit',
+    '--deck-id',
+    '--title',
+    '--caption',
+    '--visibility',
+]);
 function findPositionalDir() {
     for (let i = 1; i < args.length; i++) {
         if (args[i].startsWith('--')) {
@@ -53,7 +62,7 @@ function usage() {
   castle-web restart [--port PORT]
   castle-web screenshot [--out FILE] [--port PORT]
   castle-web save-preview-image [dir] [--port PORT] [--no-restart]
-  castle-web save-deck [dir]
+  castle-web save-deck [dir] [--title TITLE] [--caption TEXT] [--visibility unlisted|private]
   castle-web get-deck <dir> [--deck-id ID]
   castle-web login
 
@@ -87,9 +96,15 @@ async function main() {
         }
         case 'save-deck': {
             const dir = findPositionalDir();
-            await saveDeck(dir);
-            const wsPort = getWsPort(dir);
-            await savePreviewIfNeeded(dir, wsPort);
+            const title = getFlagValue('--title');
+            const caption = getFlagValue('--caption');
+            const visibility = getFlagValue('--visibility');
+            await saveDeck(dir, { title, caption, visibility });
+            // --no-preview: skip the WS canvas capture (no browser tab in headless/cloud saves).
+            if (!args.includes('--no-preview')) {
+                const wsPort = getWsPort(dir);
+                await savePreviewIfNeeded(dir, wsPort);
+            }
             break;
         }
         case 'get-deck': {

package/dist/save-deck.d.ts

@@ -1,2 +1,8 @@
 export declare function archiveSource(projectDir: string): Promise<Buffer>;
-export declare function saveDeck(dir: string): Promise<void>;
+export type SaveVisibility = 'unlisted' | 'private';
+export interface SaveDeckOptions {
+    title?: string;
+    caption?: string;
+    visibility?: SaveVisibility;
+}
+export declare function saveDeck(dir: string, opts?: SaveDeckOptions): Promise<void>;

package/dist/save-deck.js

@@ -85,11 +85,16 @@ function buildSceneData(bundle) {
         },
     };
 }
-export async function saveDeck(dir) {
+export async function saveDeck(dir, opts = {}) {
     if (!config.getToken()) {
         console.error('Not logged in. Run `castle-web login` first.');
         process.exit(1);
     }
+    const visibility = opts.visibility ?? 'unlisted';
+    if (visibility !== 'unlisted' && visibility !== 'private') {
+        console.error(`Invalid visibility "${visibility}". Use unlisted or private.`);
+        process.exit(1);
+    }
     const projectDir = path.resolve(dir);
     if (!fs.existsSync(path.join(projectDir, 'index.html'))) {
         console.error(`No index.html found in ${projectDir}`);
@@ -128,17 +133,24 @@ export async function saveDeck(dir) {
     if (s3Res.status >= 300) {
         throw new Error(`Upload failed: HTTP ${s3Res.status}`);
     }
-    // Create or update via updateCardAndDeckV2
-    const title = path.basename(path.resolve(projectDir));
+    const title = opts.title ?? castleJson?.title ?? path.basename(path.resolve(projectDir));
+    const deckInput = { deckId, title, visibility };
+    if (opts.caption !== undefined)
+        deckInput.caption = opts.caption;
     try {
-        const result = await api.updateCardAndDeckV2({ deckId, title, visibility: 'unlisted' }, { cardId, blocks: [], uploadId: uploadConfig.uploadId, makeInitialCard: true });
+        const result = await api.updateCardAndDeckV2(deckInput, {
+            cardId,
+            blocks: [],
+            uploadId: uploadConfig.uploadId,
+            makeInitialCard: true,
+        });
+        const newCastleJson = { deckId: result.deckId, cardId: result.cardId, title };
+        fs.writeFileSync(path.join(projectDir, 'castle.json'), JSON.stringify(newCastleJson, null, 2) + '\n', 'utf-8');
         if (isNew) {
-            const newCastleJson = { deckId: result.deckId, cardId: result.cardId };
-            fs.writeFileSync(path.join(projectDir, 'castle.json'), JSON.stringify(newCastleJson, null, 2) + '\n', 'utf-8');
             console.log(`Created deck "${title}" (${result.deckId}). Saved castle.json.`);
         }
         else {
-            console.log('Saved to Castle.');
+            console.log(`Saved "${title}" to Castle.`);
         }
         console.log('Uploading source archive...');
         await uploadSource(projectDir, result.deckId);