@doubledigit/cli 0.4.1 → 0.5.0

package/README.md

@@ -21,6 +21,7 @@ pnpm dd doctor
 pnpm onboard
 pnpm onboard -- --no-run
 pnpm dd actions remotion-hub
+pnpm dd actions remotion-hub init temp-project
 ```
 
 If installed globally, the binary is available as `dd`:
@@ -31,6 +32,7 @@ dd doctor
 dd onboard
 dd onboard --no-run
 dd actions remotion-hub
+dd actions remotion-hub init temp-project
 ```
 
 ## Requirements
@@ -115,12 +117,17 @@ Use `dd actions` to discover or call enabled micro-app actions through the runni
 
 ```bash
 dd actions remotion-hub
+dd actions remotion-hub init temp-project
 dd actions remotion-hub search-components --query "animated chart" --limit 5
 ```
 
-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.
+Remotion Hub `init` is handled locally by the CLI because it creates files on the caller's machine. Other Remotion Hub actions, such as search and registry lookup, call the configured Double Digit app over HTTP.
 
-The published CLI embeds a hosted default from `DD_APP_URL` during the `@doubledigit/cli` package build. The release workflow maps GitHub secrets into that variable before publishing. Localhost values are not baked into the generated package default, but `DD_APP_URL` remains available as a runtime override for a specific invocation.
+When no `--registry`, `--url`, or `--app-url` is passed, Remotion Hub init writes a registry URL from exported `DD_APP_URL`, `APP_URL`, `NEXT_PUBLIC_APP_URL`, or `BETTER_AUTH_URL`; then the release-configured hosted app URL; then `http://localhost:3111` for local development builds.
+
+For HTTP-backed actions, 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.
+
+The published CLI embeds a hosted default from `DD_ACTIONS_DEFAULT_APP_URL` during the `@doubledigit/cli` package build, falling back to `DD_APP_URL`, `NEXT_PUBLIC_APP_URL`, or `BETTER_AUTH_URL`. Localhost values are not baked into the generated package default, but `DD_APP_URL` remains available as a runtime override for a specific invocation.
 
 The hosted Double Digit app is the default for npm users:
 
@@ -136,7 +143,7 @@ Local development or self-hosted environments should override the target explici
 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 when building or publishing the CLI package. Do not rely on a local env file being present in CI.
+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 building or publishing the CLI package. 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,3 +1,9 @@
 export declare function getDefaultActionsAppUrl(): string;
+export declare function getActionPositionals(args: string[]): {
+    value: string;
+    index: number;
+}[];
+export declare function isRemotionHubInitAction(args: string[]): boolean;
+export declare function buildRemotionHubInitCommandArgs(args: string[]): 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":"AAiBA,wBAAgB,uBAAuB,WAKtC;AA+DD,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB3D"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/commands/actions.ts"],"names":[],"mappings":"AAkCA,wBAAgB,uBAAuB,WAKtC;AAgED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE;WACf,MAAM;WAAS,MAAM;IAuBxD;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,WAGrD;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,EAAE,YAI7D;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+B3D"}

package/dist/commands/actions.js

@@ -5,6 +5,22 @@ import { buildActionRequest, fetchActionRequest, isLocalAppUrl, parseActionsArgs
 import { DEFAULT_APP_URL, readEnvFile } from '../lib/onboarding.js';
 import { resolveWorkspacePaths } from '../paths.js';
 import { scanWorkspace } from '../scanner.js';
+import { runRemotionHubInitCommand } from './remotion-hub-init.js';
+const actionValueOptions = new Set([
+    '--app-url',
+    '--dir',
+    '--id-or-slug',
+    '--kind',
+    '--limit',
+    '--namespace',
+    '--preview-type',
+    '--query',
+    '--registry',
+    '--slug',
+    '--tag',
+    '--tags',
+    '--url',
+]);
 export function getDefaultActionsAppUrl() {
     return resolveDefaultActionAppUrl({
         generatedUrl: GENERATED_DEFAULT_ACTIONS_APP_URL,
@@ -33,6 +49,7 @@ Options:
 
 Examples:
   dd actions remotion-hub
+  dd actions remotion-hub init my-video --registry https://double-digit.example
   dd actions remotion-hub search-components --query "animated chart" --limit 5
   dd actions remotion-hub get-component --namespace doubledigit --slug motion-strip
   dd actions remotion-hub get-registry-payload --json '{"namespace":"doubledigit","slug":"motion-strip"}'
@@ -68,12 +85,54 @@ function tryResolveWorkspacePaths() {
         return undefined;
     }
 }
+export function getActionPositionals(args) {
+    const positionals = [];
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (!arg)
+            continue;
+        if (arg.startsWith('--')) {
+            const [flag, inlineValue] = arg.split(/=(.*)/s, 2);
+            if (flag === '--json' && inlineValue === undefined) {
+                const next = args[i + 1];
+                if (next && /^[{[]/.test(next.trim()))
+                    i++;
+            }
+            else if (inlineValue === undefined && actionValueOptions.has(flag)) {
+                const next = args[i + 1];
+                if (next && !next.startsWith('--'))
+                    i++;
+            }
+            continue;
+        }
+        if (arg === '-h')
+            continue;
+        positionals.push({ value: arg, index: i });
+    }
+    return positionals;
+}
+export function isRemotionHubInitAction(args) {
+    const positionals = getActionPositionals(args);
+    return positionals[0]?.value === 'remotion-hub' && positionals[1]?.value === 'init';
+}
+export function buildRemotionHubInitCommandArgs(args) {
+    const positionals = getActionPositionals(args);
+    const dropIndexes = new Set([positionals[0]?.index, positionals[1]?.index]);
+    return args.filter((_, index) => !dropIndexes.has(index));
+}
 export async function actions(args) {
+    if (isRemotionHubInitAction(args)) {
+        runRemotionHubInitCommand(buildRemotionHubInitCommandArgs(args));
+        return;
+    }
     const parsed = parseActionsArgs(args);
     if (parsed.help || !parsed.microApp) {
         console.log(buildHelp());
         return;
     }
+    if (parsed.extraPositionals.length > 0) {
+        throw new Error(`Unexpected positional argument: ${parsed.extraPositionals[0]}`);
+    }
     const paths = tryResolveWorkspacePaths();
     const appUrl = resolveActionAppUrl({
         explicitUrl: parsed.appUrl,

package/dist/commands/remotion-hub-init.d.ts

@@ -0,0 +1,4 @@
+import { type RunRemotionHubInitResult } from '../lib/remotion-hub-init.js';
+export declare function buildRemotionHubInitHelp(): string;
+export declare function runRemotionHubInitCommand(args: string[]): RunRemotionHubInitResult | undefined;
+//# sourceMappingURL=remotion-hub-init.d.ts.map

package/dist/commands/remotion-hub-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remotion-hub-init.d.ts","sourceRoot":"","sources":["../../src/commands/remotion-hub-init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AA8EhG,wBAAgB,wBAAwB,WAsBvC;AAcD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,wBAAwB,GAAG,SAAS,CA0B9F"}

package/dist/commands/remotion-hub-init.js

@@ -0,0 +1,120 @@
+import { runRemotionHubInit } from '../lib/remotion-hub-init.js';
+const valueFlags = new Set([
+    'app-url',
+    'dir',
+    'namespace',
+    'registry',
+    'url',
+]);
+function parseArgs(args) {
+    const positional = [];
+    const flags = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (!arg)
+            continue;
+        if (arg === '-h') {
+            flags.h = true;
+            continue;
+        }
+        if (!arg.startsWith('--')) {
+            positional.push(arg);
+            continue;
+        }
+        const [rawKey, inlineValue] = arg.slice(2).split(/=(.*)/s, 2);
+        if (!rawKey)
+            continue;
+        if (inlineValue !== undefined) {
+            flags[rawKey] = inlineValue;
+            continue;
+        }
+        if (valueFlags.has(rawKey)) {
+            const next = args[i + 1];
+            if (!next || next.startsWith('--')) {
+                throw new Error(`--${rawKey} requires a value`);
+            }
+            flags[rawKey] = next;
+            i++;
+            continue;
+        }
+        if (rawKey === 'force'
+            || rawKey === 'help'
+            || rawKey === 'hub-only'
+            || rawKey === 'json'
+            || rawKey === 'skip-remotion-create') {
+            flags[rawKey] = true;
+            continue;
+        }
+        throw new Error(`Unknown option for Remotion Hub init: --${rawKey}`);
+    }
+    return { positional, flags };
+}
+function stringFlag(flags, ...names) {
+    for (const name of names) {
+        const value = flags[name];
+        if (typeof value === 'string' && value.trim())
+            return value.trim();
+    }
+    return undefined;
+}
+function booleanFlag(flags, ...names) {
+    return names.some((name) => flags[name] === true);
+}
+export function buildRemotionHubInitHelp() {
+    return `
+dd actions remotion-hub init - Initialize a local Remotion Hub project
+
+Usage:
+  dd actions remotion-hub init [project-dir] [options]
+
+Options:
+  --dir <path>             Project directory
+  --registry <url>         Double Digit app URL or /api/remotion-hub/r endpoint
+  --url, --app-url <url>   Alias for --registry
+  --namespace <name>       Registry namespace (default: doubledigit)
+  --skip-remotion-create   Only add Remotion Hub files; do not run create-video
+  --hub-only               Alias for --skip-remotion-create
+  --force                  Overwrite existing generated files
+  --json                   Print machine-readable JSON
+
+Examples:
+  dd actions remotion-hub init
+  dd actions remotion-hub init my-video
+  dd actions remotion-hub init my-video --registry https://double-digit.example
+`;
+}
+function printInit(result) {
+    console.log(`Initialized Remotion Hub in ${result.projectDir}`);
+    if (!result.remotionCreate.skipped) {
+        console.log(`  Remotion project: ${result.remotionCreate.command} ${result.remotionCreate.args.join(' ')}`);
+    }
+    for (const file of result.created) {
+        console.log(`  ${file}`);
+    }
+    console.log('');
+    console.log(`Registry: ${result.config.registry}`);
+}
+export function runRemotionHubInitCommand(args) {
+    const parsed = parseArgs(args);
+    const json = booleanFlag(parsed.flags, 'json');
+    if (booleanFlag(parsed.flags, 'help', 'h')) {
+        console.log(buildRemotionHubInitHelp());
+        return undefined;
+    }
+    if (parsed.positional.length > 1) {
+        throw new Error('Usage: dd actions remotion-hub init [project-dir] [options]');
+    }
+    const result = runRemotionHubInit({
+        projectDir: stringFlag(parsed.flags, 'dir') ?? parsed.positional[0],
+        registry: stringFlag(parsed.flags, 'registry', 'url', 'app-url'),
+        namespace: stringFlag(parsed.flags, 'namespace'),
+        force: booleanFlag(parsed.flags, 'force'),
+        skipRemotionCreate: booleanFlag(parsed.flags, 'skip-remotion-create', 'hub-only'),
+        quiet: json,
+    });
+    if (json)
+        console.log(JSON.stringify(result, null, 2));
+    else
+        printInit(result);
+    return result;
+}

package/dist/index.d.ts

@@ -6,7 +6,7 @@
  * without importing the full extension-management dependency graph first.
  */
 declare const command: string, args: string[];
-declare const HELP = "\n@doubledigit/cli \u2014 Manage extensions and local setup\n\nCommands:\n  doctor                 Check local prerequisites and project health\n  onboard                Prepare local development and start the app\n  run                    Start the local app with automatic DB bootstrap\n  dev                    Start DB + app without migrations or seed data\n  db <subcommand>        Database helpers (status, migrate, create)\n  actions <app> [action] Discover and invoke micro-app actions\n  create <name>          Scaffold a new micro-app from the template\n  init <project-name>    Scaffold a new Double Digit project\n  add|install <source>   Install an extension from GitHub or a marketplace\n  sync                   Regenerate micro-apps.ts from dd-apps.config.json\n  enable <name>          Enable a micro-app (updates config + runs sync)\n  disable <name>         Disable a micro-app (updates config + runs sync)\n  uninstall|remove <name> Completely remove a micro-app\n  list                   List all discovered micro-apps with enabled/disabled status\n  info <name>            Show detailed info about an installed extension\n  outdated               Check for outdated marketplace extensions\n  reconcile              Detect drift between lock file, marketplace, and local files\n  marketplace <sub>      Manage marketplace registrations (add/list/update/remove)\n  browse [marketplace]   Browse available extensions in registered marketplaces\n\nOptions:\n  --help, -h             Show this help message\n\nExamples:\n  dd doctor\n  dd onboard --yes\n  dd onboard                    # setup + start the dev server\n  dd onboard --no-run           # setup only\n  dd init my-project           # scaffold and bootstrap a fresh project\n  dd init my-project --run      # scaffold + bootstrap + start\n  dd init my-project --skip-install --no-git\n  dd run\n  dd dev\n  dd db status\n  dd actions remotion-hub search-components --query \"animated chart\"\n  dd create invoice-tracker\n  dd add gh:owner/repo/extensions/micro-apps/habit-tracker\n  dd add habit-tracker@community\n  dd info habit-tracker\n  dd reconcile\n  dd marketplace add digitaldouble/dd-marketplace\n  dd browse community\n  DD_APPS=tasks,agent-v2 dd sync\n";
+declare const HELP = "\n@doubledigit/cli \u2014 Manage extensions and local setup\n\nCommands:\n  doctor                 Check local prerequisites and project health\n  onboard                Prepare local development and start the app\n  run                    Start the local app with automatic DB bootstrap\n  dev                    Start DB + app without migrations or seed data\n  db <subcommand>        Database helpers (status, migrate, create)\n  actions <app> [action] Discover and invoke micro-app actions\n  create <name>          Scaffold a new micro-app from the template\n  init <project-name>    Scaffold a new Double Digit project\n  add|install <source>   Install an extension from GitHub or a marketplace\n  sync                   Regenerate micro-apps.ts from dd-apps.config.json\n  enable <name>          Enable a micro-app (updates config + runs sync)\n  disable <name>         Disable a micro-app (updates config + runs sync)\n  uninstall|remove <name> Completely remove a micro-app\n  list                   List all discovered micro-apps with enabled/disabled status\n  info <name>            Show detailed info about an installed extension\n  outdated               Check for outdated marketplace extensions\n  reconcile              Detect drift between lock file, marketplace, and local files\n  marketplace <sub>      Manage marketplace registrations (add/list/update/remove)\n  browse [marketplace]   Browse available extensions in registered marketplaces\n\nOptions:\n  --help, -h             Show this help message\n\nExamples:\n  dd doctor\n  dd onboard --yes\n  dd onboard                    # setup + start the dev server\n  dd onboard --no-run           # setup only\n  dd init my-project           # scaffold and bootstrap a fresh project\n  dd init my-project --run      # scaffold + bootstrap + start\n  dd init my-project --skip-install --no-git\n  dd run\n  dd dev\n  dd db status\n  dd actions remotion-hub init my-video --registry https://double-digit.example\n  dd actions remotion-hub search-components --query \"animated chart\"\n  dd create invoice-tracker\n  dd add gh:owner/repo/extensions/micro-apps/habit-tracker\n  dd add habit-tracker@community\n  dd info habit-tracker\n  dd reconcile\n  dd marketplace add digitaldouble/dd-marketplace\n  dd browse community\n  DD_APPS=tasks,agent-v2 dd sync\n";
 declare function requireArg(value: string | undefined, usage: string): string;
 declare function runAddCommand(rawArgs: string[]): Promise<void>;
 declare function main(): Promise<void>;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAEH,QAAA,MAAW,OAAO,UAAK,IAAI,UAAgB,CAAC;AAE5C,QAAA,MAAM,IAAI,ysEA+CT,CAAC;AAEF,iBAAS,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAOpE;AAED,iBAAe,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB7D;AAED,iBAAe,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAsInC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAEH,QAAA,MAAW,OAAO,UAAK,IAAI,UAAgB,CAAC;AAE5C,QAAA,MAAM,IAAI,0xEAgDT,CAAC;AAEF,iBAAS,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAOpE;AAED,iBAAe,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB7D;AAED,iBAAe,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAsInC"}

package/dist/index.js

@@ -45,6 +45,7 @@ Examples:
   dd run
   dd dev
   dd db status
+  dd actions remotion-hub init my-video --registry https://double-digit.example
   dd actions remotion-hub search-components --query "animated chart"
   dd create invoice-tracker
   dd add gh:owner/repo/extensions/micro-apps/habit-tracker

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

@@ -1,6 +1,7 @@
 export interface ParsedActionsArgs {
     microApp?: string;
     actionName?: string;
+    extraPositionals: string[];
     appUrl?: string;
     input: Record<string, unknown>;
     help: boolean;

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,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,UAKnC;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"}
+{"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,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,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,UAKnC;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,CAuDlE;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

@@ -129,6 +129,7 @@ export function parseActionsArgs(args) {
     return {
         microApp: positional[0],
         actionName: positional[1],
+        extraPositionals: positional.slice(2),
         appUrl,
         input,
         help,

package/dist/lib/remotion-hub-init.d.ts

@@ -0,0 +1,66 @@
+import { spawnSync } from 'node:child_process';
+export interface RemotionHubConfig {
+    $schema: string;
+    registry: string;
+    namespace: string;
+    paths: {
+        scenes: string;
+        components: string;
+        overlays: string;
+        transitions: string;
+        assets: string;
+        registry: string;
+    };
+    remotion: {
+        entrypoint: string;
+        root: string;
+        publicDir: string;
+    };
+    packageManager: 'pnpm' | 'npm' | 'yarn' | 'bun';
+    project: {
+        language: 'typescript' | 'javascript';
+    };
+}
+export interface RemotionHubLock {
+    version: 1;
+    installed: Record<string, {
+        version: string | null;
+        type: string;
+        namespace: string;
+        slug: string;
+        resolved: string;
+        files: string[];
+        dependencies: string[];
+        installedAt: string;
+    }>;
+}
+export interface RunRemotionHubInitOptions {
+    projectDir?: string;
+    registry?: string;
+    namespace?: string;
+    force?: boolean;
+    skipRemotionCreate?: boolean;
+    quiet?: boolean;
+    spawnImpl?: typeof spawnSync;
+}
+export interface RunRemotionHubInitResult {
+    projectDir: string;
+    configPath: string;
+    lockPath: string;
+    created: string[];
+    config: RemotionHubConfig;
+    remotionCreate: {
+        skipped: boolean;
+        command: string;
+        args: string[];
+    };
+}
+export interface ResolveRemotionHubRegistryOptions {
+    registry?: string;
+    env?: Record<string, string | undefined>;
+    generatedDefaultRegistry?: string;
+    localDefaultRegistry?: string;
+}
+export declare function resolveRemotionHubRegistry({ registry, env, generatedDefaultRegistry, localDefaultRegistry, }?: ResolveRemotionHubRegistryOptions): string;
+export declare function runRemotionHubInit(options?: RunRemotionHubInitOptions): RunRemotionHubInitResult;
+//# sourceMappingURL=remotion-hub-init.d.ts.map

package/dist/lib/remotion-hub-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remotion-hub-init.d.ts","sourceRoot":"","sources":["../../src/lib/remotion-hub-init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAyB,MAAM,oBAAoB,CAAC;AAkBtE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE;QACL,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,cAAc,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;IAChD,OAAO,EAAE;QACP,QAAQ,EAAE,YAAY,GAAG,YAAY,CAAC;KACvC,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE;QACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,SAAS,CAAC;CAC9B;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,cAAc,EAAE;QACd,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;CACH;AAsFD,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAgB,0BAA0B,CAAC,EACzC,QAAQ,EACR,GAAiB,EACjB,wBAA4D,EAC5D,oBAAuC,GACxC,GAAE,iCAAsC,UAQxC;AAuJD,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,GAAG,wBAAwB,CA+CpG"}

package/dist/lib/remotion-hub-init.js

@@ -0,0 +1,254 @@
+import { spawnSync } from 'node:child_process';
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync, } from 'node:fs';
+import path from 'node:path';
+import { GENERATED_DEFAULT_ACTIONS_APP_URL } from '../generated/defaults.js';
+import { isLocalAppUrl } from './actions-client.js';
+const CONFIG_FILE = 'remotion-hub.json';
+const LOCK_FILE = 'remotion-hub.lock.json';
+const DEFAULT_REGISTRY = 'http://localhost:3111';
+const DEFAULT_NAMESPACE = 'doubledigit';
+function toJson(value) {
+    return `${JSON.stringify(value, null, 2)}\n`;
+}
+function readJsonFile(filePath, fallback) {
+    if (!existsSync(filePath))
+        return fallback;
+    return JSON.parse(readFileSync(filePath, 'utf8'));
+}
+function writeJsonFile(filePath, value) {
+    writeFileSync(filePath, toJson(value), 'utf8');
+}
+function readUrlValue(value) {
+    const trimmed = value?.trim();
+    return trimmed || undefined;
+}
+function readHostedGeneratedRegistry(value) {
+    const trimmed = readUrlValue(value);
+    if (!trimmed)
+        return undefined;
+    try {
+        return isLocalAppUrl(trimmed) ? undefined : trimmed;
+    }
+    catch {
+        return undefined;
+    }
+}
+function normalizeSlashes(value) {
+    return value.split(path.sep).join('/');
+}
+function commandCwd() {
+    return process.env.INIT_CWD || process.cwd();
+}
+function resolveProjectDir(projectDir) {
+    return path.resolve(commandCwd(), projectDir ?? '.');
+}
+function ensureRelativePath(value, label) {
+    const trimmed = value.trim();
+    if (!trimmed)
+        throw new Error(`${label} is required`);
+    if (path.isAbsolute(trimmed))
+        throw new Error(`${label} must be a relative path`);
+    const normalized = path.posix.normalize(trimmed.replace(/\\/g, '/'));
+    if (normalized === '..' || normalized.startsWith('../')) {
+        throw new Error(`${label} cannot escape the project directory`);
+    }
+    return normalized;
+}
+function resolveInsideProject(projectDir, relativePath, label) {
+    const safeRelativePath = ensureRelativePath(relativePath, label);
+    const resolved = path.resolve(projectDir, safeRelativePath);
+    const root = path.resolve(projectDir);
+    if (resolved !== root && !resolved.startsWith(`${root}${path.sep}`)) {
+        throw new Error(`${label} cannot escape the project directory`);
+    }
+    return resolved;
+}
+function detectPackageManager(projectDir) {
+    if (existsSync(path.join(projectDir, 'pnpm-lock.yaml')))
+        return 'pnpm';
+    if (existsSync(path.join(projectDir, 'yarn.lock')))
+        return 'yarn';
+    if (existsSync(path.join(projectDir, 'bun.lockb')) || existsSync(path.join(projectDir, 'bun.lock')))
+        return 'bun';
+    return 'npm';
+}
+function detectLanguage(projectDir) {
+    if (existsSync(path.join(projectDir, 'tsconfig.json')))
+        return 'typescript';
+    if (existsSync(path.join(projectDir, 'src', 'index.ts'))
+        || existsSync(path.join(projectDir, 'src', 'index.tsx'))
+        || existsSync(path.join(projectDir, 'src', 'Root.tsx'))) {
+        return 'typescript';
+    }
+    return 'javascript';
+}
+function firstExisting(projectDir, candidates, fallback) {
+    return candidates.find((candidate) => existsSync(path.join(projectDir, candidate))) ?? fallback;
+}
+export function resolveRemotionHubRegistry({ registry, env = process.env, generatedDefaultRegistry = GENERATED_DEFAULT_ACTIONS_APP_URL, localDefaultRegistry = DEFAULT_REGISTRY, } = {}) {
+    return readUrlValue(registry)
+        ?? readUrlValue(env.DD_APP_URL)
+        ?? readUrlValue(env.APP_URL)
+        ?? readUrlValue(env.NEXT_PUBLIC_APP_URL)
+        ?? readUrlValue(env.BETTER_AUTH_URL)
+        ?? readHostedGeneratedRegistry(generatedDefaultRegistry)
+        ?? localDefaultRegistry;
+}
+function defaultConfig(projectDir, options) {
+    const language = detectLanguage(projectDir);
+    const rootExtension = language === 'typescript' ? 'tsx' : 'jsx';
+    const entryExtension = language === 'typescript' ? 'ts' : 'js';
+    return {
+        $schema: 'https://remotion-hub.dev/schema/remotion-hub.json',
+        registry: resolveRemotionHubRegistry({ registry: options.registry }),
+        namespace: options.namespace?.trim() || DEFAULT_NAMESPACE,
+        paths: {
+            scenes: 'src/remotion-hub/scenes',
+            components: 'src/remotion-hub/components',
+            overlays: 'src/remotion-hub/overlays',
+            transitions: 'src/remotion-hub/transitions',
+            assets: 'public/remotion-hub/assets',
+            registry: `src/remotion-hub/registry.${entryExtension}`,
+        },
+        remotion: {
+            entrypoint: firstExisting(projectDir, ['src/index.ts', 'src/index.tsx', 'src/index.js', 'src/index.jsx'], `src/index.${entryExtension}`),
+            root: firstExisting(projectDir, ['src/Root.tsx', 'src/Root.jsx', 'src/root.tsx', 'src/root.jsx'], `src/Root.${rootExtension}`),
+            publicDir: 'public',
+        },
+        packageManager: detectPackageManager(projectDir),
+        project: {
+            language,
+        },
+    };
+}
+function defaultLock() {
+    return {
+        version: 1,
+        installed: {},
+    };
+}
+function ensureDir(projectDir, relativePath, created) {
+    const target = resolveInsideProject(projectDir, relativePath, relativePath);
+    if (!existsSync(target)) {
+        mkdirSync(target, { recursive: true });
+        created.push(normalizeSlashes(path.relative(projectDir, target)));
+    }
+}
+function registrySource(config, lock) {
+    const installed = Object.entries(lock.installed)
+        .sort(([left], [right]) => left.localeCompare(right))
+        .reduce((acc, [name, entry]) => {
+        acc[name] = {
+            type: entry.type,
+            namespace: entry.namespace,
+            slug: entry.slug,
+            files: entry.files,
+        };
+        return acc;
+    }, {});
+    const lines = [
+        '// Generated by remotion-hub. Do not edit manually.',
+        '',
+        `export const remotionHubRegistry = ${JSON.stringify(installed, null, 2)}${config.project.language === 'typescript' ? ' as const' : ''};`,
+        '',
+    ];
+    if (config.project.language === 'typescript') {
+        lines.push('export type RemotionHubRegistry = typeof remotionHubRegistry;', '');
+    }
+    return lines.join('\n');
+}
+function writeRegistryFile(projectDir, config, lock) {
+    const registryPath = resolveInsideProject(projectDir, config.paths.registry, 'paths.registry');
+    mkdirSync(path.dirname(registryPath), { recursive: true });
+    writeFileSync(registryPath, registrySource(config, lock), 'utf8');
+}
+function hasPackageJson(projectDir) {
+    return existsSync(path.join(projectDir, 'package.json'));
+}
+function hasEntries(projectDir) {
+    return existsSync(projectDir) && readdirSync(projectDir).length > 0;
+}
+function buildRemotionCreateCommand(projectDir) {
+    return {
+        command: 'npx',
+        args: ['create-video@latest', '--yes', '--blank', projectDir],
+    };
+}
+function assertRemotionCreateSucceeded(result, command, args) {
+    if (result.error) {
+        throw new Error(`Remotion project creation failed: ${result.error.message}`);
+    }
+    if (result.status !== 0) {
+        throw new Error(`Remotion project creation failed: ${command} ${args.join(' ')}`);
+    }
+}
+function ensureBaseRemotionProject(projectDir, options) {
+    const remotionCreate = buildRemotionCreateCommand(projectDir);
+    if (options.skipRemotionCreate || hasPackageJson(projectDir)) {
+        return {
+            ...remotionCreate,
+            skipped: true,
+        };
+    }
+    if (hasEntries(projectDir)) {
+        throw new Error(`Project directory exists but is not a Remotion project: ${projectDir}. `
+            + 'Remove it, choose an empty path, or run Remotion setup manually before Remotion Hub init.');
+    }
+    const result = (options.spawnImpl ?? spawnSync)(remotionCreate.command, remotionCreate.args, {
+        cwd: process.cwd(),
+        stdio: options.quiet ? 'pipe' : 'inherit',
+    });
+    assertRemotionCreateSucceeded(result, remotionCreate.command, remotionCreate.args);
+    return {
+        ...remotionCreate,
+        skipped: false,
+    };
+}
+function loadConfig(projectDir) {
+    const configPath = path.join(projectDir, CONFIG_FILE);
+    if (!existsSync(configPath)) {
+        throw new Error(`Missing ${CONFIG_FILE}. Run Remotion Hub init first.`);
+    }
+    return JSON.parse(readFileSync(configPath, 'utf8'));
+}
+export function runRemotionHubInit(options = {}) {
+    const projectDir = resolveProjectDir(options.projectDir);
+    const configPath = path.join(projectDir, CONFIG_FILE);
+    const lockPath = path.join(projectDir, LOCK_FILE);
+    const created = [];
+    const remotionCreate = ensureBaseRemotionProject(projectDir, options);
+    mkdirSync(projectDir, { recursive: true });
+    const configExists = existsSync(configPath);
+    const lockExists = existsSync(lockPath);
+    const config = configExists && !options.force
+        ? loadConfig(projectDir)
+        : defaultConfig(projectDir, options);
+    if (!configExists || options.force) {
+        writeJsonFile(configPath, config);
+        created.push(CONFIG_FILE);
+    }
+    if (!lockExists || options.force) {
+        writeJsonFile(lockPath, defaultLock());
+        created.push(LOCK_FILE);
+    }
+    for (const dir of [
+        config.paths.scenes,
+        config.paths.components,
+        config.paths.overlays,
+        config.paths.transitions,
+        config.paths.assets,
+    ]) {
+        ensureDir(projectDir, dir, created);
+    }
+    const lock = readJsonFile(lockPath, defaultLock());
+    writeRegistryFile(projectDir, config, lock);
+    created.push(config.paths.registry);
+    return {
+        projectDir,
+        configPath,
+        lockPath,
+        created,
+        config,
+        remotionCreate,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doubledigit/cli",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "private": false,
   "description": "CLI for Double Digit local setup and extension management.",
   "license": "MIT",