@doubledigit/cli 0.3.2 → 0.4.0

package/README.md

@@ -118,15 +118,23 @@ dd actions remotion-hub
 dd actions remotion-hub search-components --query "animated chart" --limit 5
 ```
 
-The command resolves the app URL from `DD_APP_URL`, `APP_URL`, `BETTER_AUTH_URL`, or `http://localhost:3111` and prints JSON responses to stdout. It also reads `.env`, `.env.local`, `apps/main-app/.env`, and `apps/main-app/.env.local`; exported shell values take precedence.
+The command resolves the app URL from exported `DD_APP_URL`, `APP_URL`, or `BETTER_AUTH_URL`; then local env-file `DD_APP_URL`; then the release-configured hosted app URL. It prints JSON responses to stdout. It also reads `.env`, `.env.local`, `apps/main-app/.env`, and `apps/main-app/.env.local`; exported shell values take precedence.
 
-Local development should use the local app URL. Use `DD_APP_URL` only when the action should intentionally hit a deployed app:
+The hosted Double Digit app is the default for npm users:
 
 ```bash
-DD_APP_URL=https://your-project.vercel.app dd actions remotion-hub
+dd actions remotion-hub
+```
+
+This hosted default does not require a local checkout or running app.
+
+Local development or self-hosted environments should override the target explicitly:
+
+```bash
+DD_APP_URL=http://localhost:3111 dd actions remotion-hub
 ```
 
-In GitHub Actions or another CI/CD runner, provide `DD_APP_URL` through the runner environment, variables, or secrets. Do not rely on a local env file being present in CI, and do not point local `.env` files at Vercel by default.
+In GitHub Actions or another CI/CD runner, provide `DD_ACTIONS_DEFAULT_APP_URL` or `DD_APP_URL` through the runner environment, variables, or secrets when the action target should differ from the hosted default. Do not rely on a local env file being present in CI.
 
 GitHub or Infisical secrets are CI/CD inputs only. A local `npx @doubledigit/cli ...` command sees your shell environment and local env files, not repository secrets.
 

package/dist/commands/actions.d.ts

@@ -1,2 +1,3 @@
+export declare function getDefaultActionsAppUrl(): string;
 export declare function actions(args: string[]): Promise<void>;
 //# sourceMappingURL=actions.d.ts.map

package/dist/commands/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/commands/actions.ts"],"names":[],"mappings":"AAiEA,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB3D"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/commands/actions.ts"],"names":[],"mappings":"AAiBA,wBAAgB,uBAAuB,WAKtC;AA+DD,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB3D"}

package/dist/commands/actions.js

@@ -1,10 +1,18 @@
 import path from 'node:path';
 import { readConfig, isEntryEnabled } from '../config.js';
+import { GENERATED_DEFAULT_ACTIONS_APP_URL } from '../generated/defaults.js';
+import { buildActionRequest, fetchActionRequest, isLocalAppUrl, parseActionsArgs, resolveActionAppUrl, resolveDefaultActionAppUrl, } from '../lib/actions-client.js';
 import { DEFAULT_APP_URL, readEnvFile } from '../lib/onboarding.js';
-import { buildActionRequest, fetchActionRequest, parseActionsArgs, resolveActionAppUrl, } from '../lib/actions-client.js';
 import { resolveWorkspacePaths } from '../paths.js';
 import { scanWorkspace } from '../scanner.js';
-const HELP = `
+export function getDefaultActionsAppUrl() {
+    return resolveDefaultActionAppUrl({
+        generatedUrl: GENERATED_DEFAULT_ACTIONS_APP_URL,
+        localDefaultUrl: DEFAULT_APP_URL,
+    });
+}
+function buildHelp() {
+    return `
 dd actions — Discover and invoke micro-app actions
 
 Usage:
@@ -12,7 +20,7 @@ Usage:
   dd actions <micro-app> <action> [options]
 
 Options:
-  --url, --app-url <url>      App URL (default: DD_APP_URL, APP_URL, BETTER_AUTH_URL, or ${DEFAULT_APP_URL})
+  --url, --app-url <url>      App URL (default: DD_APP_URL, APP_URL, BETTER_AUTH_URL, or ${getDefaultActionsAppUrl()})
   --json <json>               JSON request body to send to the action
   --query <text>              Set input.query
   --limit <number>            Set input.limit
@@ -29,6 +37,7 @@ Examples:
   dd actions remotion-hub get-component --namespace doubledigit --slug motion-strip
   dd actions remotion-hub get-registry-payload --json '{"namespace":"doubledigit","slug":"motion-strip"}'
 `;
+}
 function readActionEnvFiles(paths) {
     const env = {};
     for (const envPath of [
@@ -51,19 +60,30 @@ function validateMicroApp(paths, microApp) {
         throw new Error(`Micro-app is disabled: ${microApp}`);
     }
 }
+function tryResolveWorkspacePaths() {
+    try {
+        return resolveWorkspacePaths();
+    }
+    catch {
+        return undefined;
+    }
+}
 export async function actions(args) {
     const parsed = parseActionsArgs(args);
     if (parsed.help || !parsed.microApp) {
-        console.log(HELP);
+        console.log(buildHelp());
         return;
     }
-    const paths = resolveWorkspacePaths();
-    validateMicroApp(paths, parsed.microApp);
-    const request = buildActionRequest(parsed, resolveActionAppUrl({
+    const paths = tryResolveWorkspacePaths();
+    const appUrl = resolveActionAppUrl({
         explicitUrl: parsed.appUrl,
-        fileEnv: readActionEnvFiles(paths),
-        defaultUrl: DEFAULT_APP_URL,
-    }));
+        fileEnv: paths ? readActionEnvFiles(paths) : {},
+        defaultUrl: getDefaultActionsAppUrl(),
+    });
+    if (paths && isLocalAppUrl(appUrl)) {
+        validateMicroApp(paths, parsed.microApp);
+    }
+    const request = buildActionRequest(parsed, appUrl);
     const result = await fetchActionRequest(request);
     console.log(JSON.stringify(result, null, 2));
 }

package/dist/generated/defaults.d.ts

@@ -0,0 +1,2 @@
+export declare const GENERATED_DEFAULT_ACTIONS_APP_URL = "https://doubledigit.vercel.app";
+//# sourceMappingURL=defaults.d.ts.map

package/dist/generated/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/generated/defaults.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iCAAiC,mCAAmC,CAAC"}

package/dist/generated/defaults.js

@@ -0,0 +1 @@
+export const GENERATED_DEFAULT_ACTIONS_APP_URL = "https://doubledigit.vercel.app";

package/dist/lib/actions-client.d.ts

@@ -15,9 +15,16 @@ export interface ResolveActionAppUrlOptions {
     fileEnv?: Record<string, string | undefined>;
     defaultUrl: string;
 }
+export interface ResolveDefaultActionAppUrlOptions {
+    env?: Record<string, string | undefined>;
+    generatedUrl?: string;
+    localDefaultUrl: string;
+}
+export declare function resolveDefaultActionAppUrl({ env, generatedUrl, localDefaultUrl, }: ResolveDefaultActionAppUrlOptions): string;
 export declare function resolveActionAppUrl({ explicitUrl, env, fileEnv, defaultUrl, }: ResolveActionAppUrlOptions): string;
 export declare function parseActionsArgs(args: string[]): ParsedActionsArgs;
 export declare function normalizeAppUrl(appUrl: string): string;
+export declare function isLocalAppUrl(appUrl: string): boolean;
 export declare function buildActionRequest(parsed: Pick<ParsedActionsArgs, 'microApp' | 'actionName' | 'input'>, appUrl: string): ActionRequest;
 export declare function fetchActionRequest(request: ActionRequest): Promise<unknown>;
 //# sourceMappingURL=actions-client.d.ts.map

package/dist/lib/actions-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions-client.d.ts","sourceRoot":"","sources":["../../src/lib/actions-client.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC;CACpB;AAOD,wBAAgB,mBAAmB,CAAC,EAClC,WAAW,EACX,GAAiB,EACjB,OAAY,EACZ,UAAU,GACX,EAAE,0BAA0B,UAS5B;AA2DD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAsDlE;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,UAS7C;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,YAAY,GAAG,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAoBtI;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAuBjF"}
+{"version":3,"file":"actions-client.d.ts","sourceRoot":"","sources":["../../src/lib/actions-client.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC;CACpB;AAOD,MAAM,WAAW,iCAAiC;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,0BAA0B,CAAC,EACzC,GAAiB,EACjB,YAAY,EACZ,eAAe,GAChB,EAAE,iCAAiC,UAInC;AAED,wBAAgB,mBAAmB,CAAC,EAClC,WAAW,EACX,GAAiB,EACjB,OAAY,EACZ,UAAU,GACX,EAAE,0BAA0B,UAS5B;AA2DD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAsDlE;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,UAS7C;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,WAK3C;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,YAAY,GAAG,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAoBtI;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAuBjF"}

package/dist/lib/actions-client.js

@@ -2,15 +2,20 @@ function readUrlValue(value) {
     const trimmed = value?.trim();
     return trimmed || undefined;
 }
+export function resolveDefaultActionAppUrl({ env = process.env, generatedUrl, localDefaultUrl, }) {
+    return readUrlValue(env.DD_ACTIONS_DEFAULT_APP_URL)
+        ?? readUrlValue(generatedUrl)
+        ?? localDefaultUrl;
+}
 export function resolveActionAppUrl({ explicitUrl, env = process.env, fileEnv = {}, defaultUrl, }) {
     return readUrlValue(explicitUrl)
         ?? readUrlValue(env.DD_APP_URL)
         ?? readUrlValue(env.APP_URL)
         ?? readUrlValue(env.BETTER_AUTH_URL)
         ?? readUrlValue(fileEnv.DD_APP_URL)
+        ?? defaultUrl
         ?? readUrlValue(fileEnv.APP_URL)
-        ?? readUrlValue(fileEnv.BETTER_AUTH_URL)
-        ?? defaultUrl;
+        ?? readUrlValue(fileEnv.BETTER_AUTH_URL);
 }
 function requireValue(args, index, flag) {
     const value = args[index + 1];
@@ -138,6 +143,12 @@ export function normalizeAppUrl(appUrl) {
     }
     return `https://${trimmed}`;
 }
+export function isLocalAppUrl(appUrl) {
+    const parsed = new URL(normalizeAppUrl(appUrl));
+    return parsed.hostname === 'localhost'
+        || parsed.hostname === '127.0.0.1'
+        || parsed.hostname === '::1';
+}
 export function buildActionRequest(parsed, appUrl) {
     if (!parsed.microApp) {
         throw new Error('missing micro-app name');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doubledigit/cli",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "private": false,
   "description": "CLI for Double Digit local setup and extension management.",
   "license": "MIT",
@@ -50,7 +50,8 @@
   },
   "scripts": {
     "test": "tsx --test test/*.test.ts",
-    "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit"
+    "build": "pnpm generate:defaults && tsc -p tsconfig.json",
+    "generate:defaults": "node scripts/generate-defaults.mjs",
+    "typecheck": "pnpm generate:defaults && tsc -p tsconfig.json --noEmit"
   }
 }