@ductape/cli 0.2.19 → 0.2.22

package/dist/commands/apply.js

@@ -13,20 +13,62 @@ async function syncItems(type, items, productTag, proxy, dryRun) {
     const listResult = await proxy.execute(module, 'list', buildCrudParams(module, 'list', productTag, {}));
     const existingList = Array.isArray(listResult) ? listResult : [];
     const existingTags = new Set(existingList.map((r) => r.tag ?? '').filter(Boolean));
+    const existingNotificationMessages = new Set();
+    if (type === 'notifications') {
+        for (const notification of existingList) {
+            const record = notification;
+            for (const message of record.messages ?? []) {
+                if (record.tag && message.tag) {
+                    existingNotificationMessages.add(message.tag.includes(':') ? message.tag : `${record.tag}:${message.tag}`);
+                }
+            }
+        }
+    }
     for (const item of items) {
         if (!item.tag) {
             console.warn(`  [${type}] skipped — missing "tag" field`);
             continue;
         }
         const verb = existingTags.has(item.tag) ? 'update' : 'create';
+        const nestedMessages = type === 'notifications' && Array.isArray(item.messages)
+            ? item.messages
+            : [];
+        const componentBody = type === 'notifications'
+            ? Object.fromEntries(Object.entries(item).filter(([key]) => key !== 'messages'))
+            : item;
         if (dryRun) {
             console.log(`  [${type}] would ${verb}: ${item.tag}`);
+            for (const message of nestedMessages) {
+                const rawTag = String(message.tag ?? '');
+                const fullTag = rawTag.includes(':') ? rawTag : `${item.tag}:${rawTag}`;
+                const messageVerb = existingNotificationMessages.has(fullTag) ? 'update' : 'create';
+                console.log(`  [notifications] would ${messageVerb} message: ${fullTag}`);
+            }
             continue;
         }
         try {
-            const params = buildCrudParams(module, verb, productTag, { tag: item.tag, body: item });
+            const params = buildCrudParams(module, verb, productTag, {
+                tag: item.tag,
+                body: componentBody,
+            });
             await proxy.execute(module, verb, params);
             console.log(`  [${type}] ${verb}d: ${item.tag}`);
+            for (const message of nestedMessages) {
+                const rawTag = String(message.tag ?? '');
+                if (!rawTag)
+                    throw new Error(`notification "${item.tag}" contains a message without "tag"`);
+                const fullTag = rawTag.includes(':') ? rawTag : `${item.tag}:${rawTag}`;
+                if (!fullTag.startsWith(`${item.tag}:`)) {
+                    throw new Error(`message tag "${fullTag}" must belong to notification "${item.tag}"`);
+                }
+                const messageBody = { ...message, tag: fullTag };
+                const messageVerb = existingNotificationMessages.has(fullTag) ? 'update' : 'create';
+                const messageParams = messageVerb === 'create'
+                    ? [productTag, messageBody]
+                    : [productTag, fullTag, messageBody];
+                await proxy.execute('notifications', `messages.${messageVerb}`, messageParams);
+                console.log(`  [notifications] ${messageVerb}d message: ${fullTag}`);
+            }
         }
         catch (err) {
             console.error(`  [${type}] ${verb} failed for "${item.tag}": ${err instanceof Error ? err.message : String(err)}`);
@@ -54,8 +96,7 @@ export async function runApply(type, opts) {
             items = loaders[t]();
         }
         catch (err) {
-            console.error(`[${t}] parse error: ${err instanceof Error ? err.message : String(err)}`);
-            continue;
+            fail(`[${t}] parse error: ${err instanceof Error ? err.message : String(err)}`);
         }
         if (items === null) {
             console.log(`[${t}] no ductape/${t}.json found — skipping`);

package/dist/commands/products.d.ts

@@ -12,6 +12,12 @@ export declare function runProductApps(verb: string, opts: {
     product?: string;
     json?: boolean;
 }, extraArgs: string[]): Promise<void>;
+export declare function runProductComponents(verb: string, opts: {
+    profile?: string;
+    tag?: string;
+    type?: string;
+    json?: boolean;
+}): Promise<void>;
 export declare function runProductEnvironments(verb: string, opts: {
     product?: string;
     tag?: string;

package/dist/commands/products.js

@@ -73,6 +73,91 @@ export async function runProductApps(verb, opts, extraArgs) {
     const result = await listProductApps(ctx, productId);
     printJson(result, Boolean(opts.json));
 }
+const COMPONENT_KEYS = {
+    apps: ['apps'],
+    databases: ['databases'],
+    storage: ['storage'],
+    caches: ['caches'],
+    graphs: ['graphs'],
+    vectors: ['vectors', 'vector_databases'],
+    notifications: ['notifications'],
+    events: ['message_brokers', 'messageBrokers', 'brokers'],
+    sessions: ['sessions'],
+    features: ['features'],
+    jobs: ['jobs'],
+};
+function unwrapProduct(value) {
+    if (!value || typeof value !== 'object')
+        return {};
+    const record = value;
+    return record.data && typeof record.data === 'object'
+        ? record.data
+        : record;
+}
+function summarizeComponent(value) {
+    const component = (value && typeof value === 'object' ? value : {});
+    const summary = {};
+    for (const key of ['_id', 'id', 'tag', 'name', 'description', 'type', 'status']) {
+        if (component[key] !== undefined)
+            summary[key] = component[key];
+    }
+    if (Array.isArray(component.envs)) {
+        summary.envs = component.envs.map((env) => {
+            const item = (env && typeof env === 'object' ? env : {});
+            return { slug: item.slug, type: item.type, cloud: item.cloud };
+        });
+    }
+    for (const nestedKey of ['topics', 'messages']) {
+        if (Array.isArray(component[nestedKey])) {
+            summary[nestedKey] = component[nestedKey].map((nested) => {
+                const item = (nested && typeof nested === 'object' ? nested : {});
+                return {
+                    tag: item.tag,
+                    name: item.name,
+                    description: item.description,
+                };
+            });
+        }
+    }
+    return summary;
+}
+export async function runProductComponents(verb, opts) {
+    const normalizedVerb = verb.toLowerCase();
+    if (!['list', 'get'].includes(normalizedVerb)) {
+        throw new Error('Product components verb must be: list | get');
+    }
+    if (!opts.tag)
+        throw new Error('--tag <product_tag> is required');
+    const ctx = requireWorkspaceContext({ profile: opts.profile });
+    const product = unwrapProduct(await getProduct(ctx, { tag: opts.tag }));
+    const selectedTypes = normalizedVerb === 'get'
+        ? [opts.type?.toLowerCase()].filter(Boolean)
+        : Object.keys(COMPONENT_KEYS);
+    if (normalizedVerb === 'get' && !selectedTypes.length) {
+        throw new Error('--type <component_type> is required for get');
+    }
+    for (const type of selectedTypes) {
+        if (!COMPONENT_KEYS[type]) {
+            throw new Error(`Unknown component type "${type}". Use: ${Object.keys(COMPONENT_KEYS).join(', ')}`);
+        }
+    }
+    const components = {};
+    for (const type of selectedTypes) {
+        const sourceKey = COMPONENT_KEYS[type].find((key) => Array.isArray(product[key]));
+        components[type] = sourceKey
+            ? product[sourceKey].map(summarizeComponent)
+            : [];
+    }
+    const envSource = Array.isArray(product.envs) ? product.envs : [];
+    printJson({
+        tag: product.tag ?? opts.tag,
+        environments: envSource.map((env) => {
+            const item = (env && typeof env === 'object' ? env : {});
+            return { slug: item.slug, name: item.name ?? item.env_name };
+        }),
+        components,
+    }, Boolean(opts.json));
+}
 export async function runProductEnvironments(verb, opts, extraArgs) {
     const v = verb.toLowerCase();
     const allowed = ['list', 'get', 'fetch'];

package/dist/commands/resources.js

@@ -59,6 +59,21 @@ export async function runEventTopicCrud(verb, opts, extraArgs) {
     }
     const proxy = getSdkProxy(session);
     const result = await proxy.execute('messageBrokers', method, params);
+    if (crud === 'create') {
+        const fullTag = String(body?.tag ?? '');
+        if (!fullTag.includes(':')) {
+            throw new Error('Topic create response could not be verified because body.tag is invalid');
+        }
+        const verified = await proxy.execute('messageBrokers', 'topics.fetch', [productTag, fullTag]);
+        if (!verified) {
+            throw new Error(`Topic creation returned without an error, but "${fullTag}" was not found during verification`);
+        }
+        printJson({ created: true, topic: verified }, Boolean(opts.json));
+        return;
+    }
+    if (crud === 'get' && !result) {
+        throw new Error(`Topic "${tag}" was not found`);
+    }
     printJson(result, Boolean(opts.json));
 }
 export async function runNotificationMessageCrud(verb, opts) {
@@ -91,7 +106,25 @@ export async function runNotificationMessageCrud(verb, opts) {
             throw new Error('--tag <notification:message> is required');
         params = [product, opts.tag, body ?? {}];
     }
-    printJson(await proxy.execute('notifications', method, params), Boolean(opts.json));
+    try {
+        printJson(await proxy.execute('notifications', method, params), Boolean(opts.json));
+    }
+    catch (error) {
+        if (crud !== 'list' || !opts.notification)
+            throw error;
+        // Compatibility fallback for platform versions whose message lookup uses a stale product
+        // snapshot while the component inventory already contains the notification.
+        const listed = await proxy.execute('notifications', 'list', buildCrudParams('notifications', 'list', product, {}));
+        const notifications = Array.isArray(listed)
+            ? listed
+            : Array.isArray(listed?.data)
+                ? listed.data
+                : [];
+        const notification = notifications.find((item) => item.tag === opts.notification);
+        if (!notification)
+            throw error;
+        printJson(notification.messages ?? [], Boolean(opts.json));
+    }
 }
 export async function runResourceCrud(typeName, verb, opts, extraArgs) {
     const crud = verb.toLowerCase();

package/dist/index.js

@@ -22,7 +22,7 @@ import { runSecrets } from './commands/secrets.js';
 import { runWorkspacesCurrent, runWorkspacesList, runWorkspacesRefresh, runWorkspacesUse, } from './commands/workspaces.js';
 import { runGeneratePayload, runGenerateSnippet } from './commands/generate.js';
 import { runCompletion } from './commands/completion.js';
-import { runProducts, runProductApps, runProductEnvironments } from './commands/products.js';
+import { runProducts, runProductApps, runProductComponents, runProductEnvironments } from './commands/products.js';
 import { runApps } from './commands/apps.js';
 import { runAppsImport } from './commands/apps-import.js';
 import { runApply } from './commands/apply.js';
@@ -192,6 +192,22 @@ productApps
     .option('--product <id>', 'Product _id')
     .option('--json', 'JSON output')
     .action(wrap((opts) => runProductApps('list', opts, [])));
+const productComponents = products
+    .command('components')
+    .description('Compact, non-secret product component inventory');
+productComponents
+    .command('list')
+    .requiredOption('-t, --tag <tag>', 'Product tag')
+    .option('--profile <name>')
+    .option('--json', 'JSON output')
+    .action(wrap((opts) => runProductComponents('list', opts)));
+productComponents
+    .command('get')
+    .requiredOption('-t, --tag <tag>', 'Product tag')
+    .requiredOption('--type <type>', 'Component type, e.g. notifications or events')
+    .option('--profile <name>')
+    .option('--json', 'JSON output')
+    .action(wrap((opts) => runProductComponents('get', opts)));
 const productEnvironments = products
     .command('environments')
     .description('Product environments (list, get)');

package/dist/lib/http.js

@@ -13,6 +13,10 @@ export async function parseJsonResponse(res, url) {
         return JSON.parse(text);
     }
     catch {
+        if (res.status === 504) {
+            throw new Error(`Ductape proxy gateway timeout (HTTP 504) for ${url}. The operation did not return a ` +
+                'verifiable result; retry only after checking whether the asset was created.');
+        }
         const htmlHint = text.trimStart().startsWith('<')
             ? [
                 '',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ductape/cli",
-  "version": "0.2.19",
+  "version": "0.2.22",
   "description": "Ductape CLI — local platform, login, link projects, and manage resources via the proxy (Workbench-compatible)",
   "type": "module",
   "main": "dist/index.js",

package/src/commands/apply.ts

@@ -36,6 +36,19 @@ async function syncItems(
   const existingTags = new Set(
     existingList.map((r) => (r as { tag?: string }).tag ?? '').filter(Boolean),
   );
+  const existingNotificationMessages = new Set<string>();
+  if (type === 'notifications') {
+    for (const notification of existingList) {
+      const record = notification as { tag?: string; messages?: Array<{ tag?: string }> };
+      for (const message of record.messages ?? []) {
+        if (record.tag && message.tag) {
+          existingNotificationMessages.add(
+            message.tag.includes(':') ? message.tag : `${record.tag}:${message.tag}`,
+          );
+        }
+      }
+    }
+  }
 
   for (const item of items) {
     if (!item.tag) {
@@ -44,16 +57,52 @@ async function syncItems(
     }
 
     const verb: 'create' | 'update' = existingTags.has(item.tag) ? 'update' : 'create';
+    const nestedMessages =
+      type === 'notifications' && Array.isArray(item.messages)
+        ? item.messages as Array<Record<string, unknown>>
+        : [];
+    const componentBody =
+      type === 'notifications'
+        ? Object.fromEntries(Object.entries(item).filter(([key]) => key !== 'messages'))
+        : item;
 
     if (dryRun) {
       console.log(`  [${type}] would ${verb}: ${item.tag}`);
+      for (const message of nestedMessages) {
+        const rawTag = String(message.tag ?? '');
+        const fullTag = rawTag.includes(':') ? rawTag : `${item.tag}:${rawTag}`;
+        const messageVerb = existingNotificationMessages.has(fullTag) ? 'update' : 'create';
+        console.log(`  [notifications] would ${messageVerb} message: ${fullTag}`);
+      }
       continue;
     }
 
     try {
-      const params = buildCrudParams(module, verb, productTag, { tag: item.tag, body: item });
+      const params = buildCrudParams(module, verb, productTag, {
+        tag: item.tag,
+        body: componentBody,
+      });
       await proxy.execute(module, verb, params);
       console.log(`  [${type}] ${verb}d: ${item.tag}`);
+
+      for (const message of nestedMessages) {
+        const rawTag = String(message.tag ?? '');
+        if (!rawTag) throw new Error(`notification "${item.tag}" contains a message without "tag"`);
+        const fullTag = rawTag.includes(':') ? rawTag : `${item.tag}:${rawTag}`;
+        if (!fullTag.startsWith(`${item.tag}:`)) {
+          throw new Error(
+            `message tag "${fullTag}" must belong to notification "${item.tag}"`,
+          );
+        }
+        const messageBody = { ...message, tag: fullTag };
+        const messageVerb = existingNotificationMessages.has(fullTag) ? 'update' : 'create';
+        const messageParams =
+          messageVerb === 'create'
+            ? [productTag, messageBody]
+            : [productTag, fullTag, messageBody];
+        await proxy.execute('notifications', `messages.${messageVerb}`, messageParams);
+        console.log(`  [notifications] ${messageVerb}d message: ${fullTag}`);
+      }
     } catch (err) {
       console.error(
         `  [${type}] ${verb} failed for "${item.tag}": ${err instanceof Error ? err.message : String(err)}`,
@@ -85,8 +134,7 @@ export async function runApply(type: ApplyType | undefined, opts: ApplyOpts): Pr
     try {
       items = loaders[t]();
     } catch (err) {
-      console.error(`[${t}] parse error: ${err instanceof Error ? err.message : String(err)}`);
-      continue;
+      fail(`[${t}] parse error: ${err instanceof Error ? err.message : String(err)}`);
     }
 
     if (items === null) {

package/src/commands/products.ts

@@ -104,6 +104,101 @@ export async function runProductApps(
   printJson(result, Boolean(opts.json));
 }
 
+const COMPONENT_KEYS: Record<string, string[]> = {
+  apps: ['apps'],
+  databases: ['databases'],
+  storage: ['storage'],
+  caches: ['caches'],
+  graphs: ['graphs'],
+  vectors: ['vectors', 'vector_databases'],
+  notifications: ['notifications'],
+  events: ['message_brokers', 'messageBrokers', 'brokers'],
+  sessions: ['sessions'],
+  features: ['features'],
+  jobs: ['jobs'],
+};
+
+function unwrapProduct(value: unknown): Record<string, unknown> {
+  if (!value || typeof value !== 'object') return {};
+  const record = value as Record<string, unknown>;
+  return record.data && typeof record.data === 'object'
+    ? (record.data as Record<string, unknown>)
+    : record;
+}
+
+function summarizeComponent(value: unknown): Record<string, unknown> {
+  const component = (value && typeof value === 'object' ? value : {}) as Record<string, unknown>;
+  const summary: Record<string, unknown> = {};
+  for (const key of ['_id', 'id', 'tag', 'name', 'description', 'type', 'status']) {
+    if (component[key] !== undefined) summary[key] = component[key];
+  }
+  if (Array.isArray(component.envs)) {
+    summary.envs = component.envs.map((env) => {
+      const item = (env && typeof env === 'object' ? env : {}) as Record<string, unknown>;
+      return { slug: item.slug, type: item.type, cloud: item.cloud };
+    });
+  }
+  for (const nestedKey of ['topics', 'messages']) {
+    if (Array.isArray(component[nestedKey])) {
+      summary[nestedKey] = (component[nestedKey] as unknown[]).map((nested) => {
+        const item = (nested && typeof nested === 'object' ? nested : {}) as Record<string, unknown>;
+        return {
+          tag: item.tag,
+          name: item.name,
+          description: item.description,
+        };
+      });
+    }
+  }
+  return summary;
+}
+
+export async function runProductComponents(
+  verb: string,
+  opts: { profile?: string; tag?: string; type?: string; json?: boolean },
+): Promise<void> {
+  const normalizedVerb = verb.toLowerCase();
+  if (!['list', 'get'].includes(normalizedVerb)) {
+    throw new Error('Product components verb must be: list | get');
+  }
+  if (!opts.tag) throw new Error('--tag <product_tag> is required');
+
+  const ctx = requireWorkspaceContext({ profile: opts.profile });
+  const product = unwrapProduct(await getProduct(ctx, { tag: opts.tag }));
+  const selectedTypes =
+    normalizedVerb === 'get'
+      ? [opts.type?.toLowerCase()].filter(Boolean) as string[]
+      : Object.keys(COMPONENT_KEYS);
+  if (normalizedVerb === 'get' && !selectedTypes.length) {
+    throw new Error('--type <component_type> is required for get');
+  }
+  for (const type of selectedTypes) {
+    if (!COMPONENT_KEYS[type]) {
+      throw new Error(`Unknown component type "${type}". Use: ${Object.keys(COMPONENT_KEYS).join(', ')}`);
+    }
+  }
+
+  const components: Record<string, unknown[]> = {};
+  for (const type of selectedTypes) {
+    const sourceKey = COMPONENT_KEYS[type].find((key) => Array.isArray(product[key]));
+    components[type] = sourceKey
+      ? (product[sourceKey] as unknown[]).map(summarizeComponent)
+      : [];
+  }
+  const envSource = Array.isArray(product.envs) ? product.envs : [];
+  printJson(
+    {
+      tag: product.tag ?? opts.tag,
+      environments: envSource.map((env) => {
+        const item = (env && typeof env === 'object' ? env : {}) as Record<string, unknown>;
+        return { slug: item.slug, name: item.name ?? item.env_name };
+      }),
+      components,
+    },
+    Boolean(opts.json),
+  );
+}
+
 export async function runProductEnvironments(
   verb: string,
   opts: { product?: string; tag?: string; slug?: string; json?: boolean },

package/src/commands/resources.ts

@@ -70,6 +70,27 @@ export async function runEventTopicCrud(
 
   const proxy = getSdkProxy(session);
   const result = await proxy.execute('messageBrokers', method, params);
+  if (crud === 'create') {
+    const fullTag = String((body as { tag?: unknown } | undefined)?.tag ?? '');
+    if (!fullTag.includes(':')) {
+      throw new Error('Topic create response could not be verified because body.tag is invalid');
+    }
+    const verified = await proxy.execute(
+      'messageBrokers',
+      'topics.fetch',
+      [productTag, fullTag],
+    );
+    if (!verified) {
+      throw new Error(
+        `Topic creation returned without an error, but "${fullTag}" was not found during verification`,
+      );
+    }
+    printJson({ created: true, topic: verified }, Boolean(opts.json));
+    return;
+  }
+  if (crud === 'get' && !result) {
+    throw new Error(`Topic "${tag}" was not found`);
+  }
   printJson(result, Boolean(opts.json));
 }
 
@@ -100,7 +121,29 @@ export async function runNotificationMessageCrud(
     if (!opts.tag) throw new Error('--tag <notification:message> is required');
     params = [product, opts.tag, body ?? {}];
   }
-  printJson(await proxy.execute('notifications', method, params), Boolean(opts.json));
+  try {
+    printJson(await proxy.execute('notifications', method, params), Boolean(opts.json));
+  } catch (error) {
+    if (crud !== 'list' || !opts.notification) throw error;
+
+    // Compatibility fallback for platform versions whose message lookup uses a stale product
+    // snapshot while the component inventory already contains the notification.
+    const listed = await proxy.execute<unknown>(
+      'notifications',
+      'list',
+      buildCrudParams('notifications', 'list', product, {}),
+    );
+    const notifications = Array.isArray(listed)
+      ? listed
+      : Array.isArray((listed as { data?: unknown[] } | null)?.data)
+        ? (listed as { data: unknown[] }).data
+        : [];
+    const notification = notifications.find(
+      (item) => (item as { tag?: string }).tag === opts.notification,
+    ) as { messages?: unknown[] } | undefined;
+    if (!notification) throw error;
+    printJson(notification.messages ?? [], Boolean(opts.json));
+  }
 }
 
 export async function runResourceCrud(

package/src/index.ts

@@ -27,7 +27,7 @@ import {
 } from './commands/workspaces.js';
 import { runGeneratePayload, runGenerateSnippet } from './commands/generate.js';
 import { runCompletion } from './commands/completion.js';
-import { runProducts, runProductApps, runProductEnvironments } from './commands/products.js';
+import { runProducts, runProductApps, runProductComponents, runProductEnvironments } from './commands/products.js';
 import { runApps } from './commands/apps.js';
 import { runAppsImport } from './commands/apps-import.js';
 import { runApply, type ApplyType } from './commands/apply.js';
@@ -248,6 +248,25 @@ productApps
   .option('--json', 'JSON output')
   .action(wrap((opts) => runProductApps('list', opts, [])));
 
+const productComponents = products
+  .command('components')
+  .description('Compact, non-secret product component inventory');
+
+productComponents
+  .command('list')
+  .requiredOption('-t, --tag <tag>', 'Product tag')
+  .option('--profile <name>')
+  .option('--json', 'JSON output')
+  .action(wrap((opts) => runProductComponents('list', opts)));
+
+productComponents
+  .command('get')
+  .requiredOption('-t, --tag <tag>', 'Product tag')
+  .requiredOption('--type <type>', 'Component type, e.g. notifications or events')
+  .option('--profile <name>')
+  .option('--json', 'JSON output')
+  .action(wrap((opts) => runProductComponents('get', opts)));
+
 const productEnvironments = products
   .command('environments')
   .description('Product environments (list, get)');

package/src/lib/http.ts

@@ -16,6 +16,12 @@ export async function parseJsonResponse<T = Record<string, unknown>>(
   try {
     return JSON.parse(text) as T;
   } catch {
+    if (res.status === 504) {
+      throw new Error(
+        `Ductape proxy gateway timeout (HTTP 504) for ${url}. The operation did not return a ` +
+        'verifiable result; retry only after checking whether the asset was created.',
+      );
+    }
     const htmlHint = text.trimStart().startsWith('<')
       ? [
           '',

package/test/apply-loaders.test.ts

@@ -0,0 +1,40 @@
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import test from 'node:test';
+import { loadNotifications } from '../src/lib/apply-loaders.js';
+
+test('notifications declaration must be a top-level array', () => {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'ductape-notifications-'));
+  const configDir = path.join(dir, 'ductape');
+  fs.mkdirSync(configDir);
+  fs.writeFileSync(
+    path.join(configDir, 'notifications.json'),
+    JSON.stringify({ notifications: [], messages: [] }),
+  );
+
+  assert.throws(
+    () => loadNotifications(dir),
+    /notifications\.json must be a JSON array/,
+  );
+});
+
+test('notifications declaration accepts nested messages', () => {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'ductape-notifications-'));
+  const configDir = path.join(dir, 'ductape');
+  fs.mkdirSync(configDir);
+  fs.writeFileSync(
+    path.join(configDir, 'notifications.json'),
+    JSON.stringify([
+      {
+        tag: 'game-alerts-critical',
+        messages: [{ tag: 'game-alerts-critical:match-launch', name: 'Match launch' }],
+      },
+    ]),
+  );
+
+  const result = loadNotifications(dir);
+  assert.equal(result?.length, 1);
+  assert.equal(result?.[0].tag, 'game-alerts-critical');
+});

package/test/http.test.ts

@@ -0,0 +1,15 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { parseJsonResponse } from '../src/lib/http.js';
+
+test('surfaces an HTML gateway timeout as a structured proxy failure', async () => {
+  const response = new Response('<html><h1>504 Gateway Time-out</h1></html>', {
+    status: 504,
+    headers: { 'content-type': 'text/html' },
+  });
+
+  await assert.rejects(
+    () => parseJsonResponse(response, 'https://api.ductape.app/proxy/v1/sdk-proxy/execute'),
+    /Ductape proxy gateway timeout \(HTTP 504\).*did not return a verifiable result/,
+  );
+});