anhedral 0.3.0 → 0.4.0

package/dist/architecture/contributions.js

@@ -71,6 +71,13 @@ const MODULE_CONTRIBUTIONS = Object.freeze({
         environment: EMPTY,
         crons: EMPTY,
     }),
+    'electron-updater': Object.freeze({
+        module: 'electron-updater',
+        environment: Object.freeze([
+            { name: 'DESKTOP_UPDATE_BASE_URL', defaultValue: 'https://updates.example.com' },
+        ]),
+        crons: EMPTY,
+    }),
 });
 function collectEnvironmentFromRegistry(modules, registry) {
     const byName = new Map();

package/dist/architecture/modules.d.ts

@@ -1,4 +1,4 @@
-export declare const MODULE_IDS: readonly ["web", "mobile", "api", "desktop", "extension", "db", "auth", "billing", "storage", "native-subscriptions"];
+export declare const MODULE_IDS: readonly ["web", "mobile", "api", "desktop", "extension", "db", "auth", "billing", "storage", "native-subscriptions", "electron-updater"];
 export type ModuleId = (typeof MODULE_IDS)[number];
 export type ModuleKind = 'app' | 'feature';
 export type ModuleDefinition = {
@@ -33,5 +33,5 @@ export declare class ModuleResolutionError extends Error {
 export declare function isModuleId(value: unknown): value is ModuleId;
 export declare function createModuleRegistry(definitions: readonly ModuleDefinition[]): ModuleRegistry;
 export declare const DEFAULT_MODULE_DEFINITIONS: readonly ModuleDefinition[];
-export declare const DEFAULT_MODULE_REGISTRY: Readonly<Record<"auth" | "billing" | "storage" | "api" | "desktop" | "web" | "mobile" | "extension" | "db" | "native-subscriptions", ModuleDefinition>>;
+export declare const DEFAULT_MODULE_REGISTRY: Readonly<Record<"electron-updater" | "auth" | "billing" | "storage" | "api" | "desktop" | "web" | "mobile" | "extension" | "db" | "native-subscriptions", ModuleDefinition>>;
 export declare function resolveModules(requested: readonly string[], registry?: ModuleRegistry): ModuleResolution;

package/dist/architecture/modules.js

@@ -9,6 +9,7 @@ export const MODULE_IDS = [
     'billing',
     'storage',
     'native-subscriptions',
+    'electron-updater',
 ];
 export class ModuleRegistryError extends Error {
     code;
@@ -119,6 +120,7 @@ const DEFAULT_MODULE_DEFINITION_INPUTS = [
     { id: 'billing', kind: 'feature', requires: ['auth'], conflicts: [] },
     { id: 'storage', kind: 'feature', requires: ['auth'], conflicts: [] },
     { id: 'native-subscriptions', kind: 'feature', requires: ['mobile', 'billing'], conflicts: [] },
+    { id: 'electron-updater', kind: 'feature', requires: ['desktop'], conflicts: [] },
 ];
 export const DEFAULT_MODULE_DEFINITIONS = Object.freeze(DEFAULT_MODULE_DEFINITION_INPUTS.map(freezeDefinition));
 export const DEFAULT_MODULE_REGISTRY = createModuleRegistry(DEFAULT_MODULE_DEFINITIONS);
@@ -162,14 +164,20 @@ export function resolveModules(requested, registry = DEFAULT_MODULE_REGISTRY) {
         const modules = Object.freeze([...new Set(conflicts.flat())].sort(compareModules));
         throw new ModuleResolutionError('MODULE_CONFLICT', `Conflicting modules: ${conflicts.map(([left, right]) => `${left} + ${right}`).join(', ')}`, modules);
     }
+    // Resolution must have one stable representation regardless of whether a
+    // dependency was requested directly or discovered while walking another
+    // module. Without this final normalization, adding a module to an existing
+    // project could produce a different manifest order than creating the same
+    // topology directly (for example, adding electron-updater after db/auth).
+    const resolvedModules = normalizeModuleList(ordered);
     const requestedSet = new Set(requestedModules);
-    const dependencyAddedModules = ordered.filter((moduleId) => !requestedSet.has(moduleId));
-    const dependencyEdges = ordered.flatMap((moduleId) => registry[moduleId].requires
+    const dependencyAddedModules = resolvedModules.filter((moduleId) => !requestedSet.has(moduleId));
+    const dependencyEdges = resolvedModules.flatMap((moduleId) => registry[moduleId].requires
         .filter((required) => resolved.has(required))
         .map((required) => Object.freeze({ module: moduleId, requires: required })));
     return Object.freeze({
         requestedModules,
-        resolvedModules: Object.freeze(ordered),
+        resolvedModules,
         dependencyAddedModules: Object.freeze(dependencyAddedModules),
         dependencyEdges: Object.freeze(dependencyEdges),
     });

package/dist/bin.js

@@ -2,7 +2,7 @@
 import { createInterface } from 'node:readline/promises';
 import { argv, stdin, stdout } from 'node:process';
 import { buildAddOptions, buildOptions, buildOptionsForRoot, parseCli, parseNewProjectRequest, parseUiAddOptions, USAGE } from './cli.js';
-import { doctorProject, scaffoldAddModules, scaffoldProject, scaffoldUiComponents } from './scaffold.js';
+import { doctorProject, scaffoldAddModules, scaffoldProject, scaffoldUiComponents, scaffoldUpgradeProject } from './scaffold.js';
 import { DEFAULT_PROMPT_APP_MODULES, DEFAULT_PROMPT_FEATURE_MODULES, hasUiSelection, parsePromptModules, shouldPromptForInitModules, } from './prompts.js';
 import { GENERATOR_VERSION } from './version.js';
 import { PostCommitError } from './transaction.js';
@@ -41,7 +41,7 @@ async function promptForInitModules(args) {
     try {
         console.log('Select app surfaces: web, mobile, api, desktop, extension');
         const appAnswer = await rl.question('App surfaces [all]: ');
-        console.log('Select backend features: db, auth, billing, storage, native-subscriptions');
+        console.log('Select backend features: db, auth, billing, storage, native-subscriptions, electron-updater');
         const featureAnswer = await rl.question('Backend features [all]: ');
         const selected = [
             ...parsePromptModules(appAnswer, DEFAULT_PROMPT_APP_MODULES),
@@ -89,7 +89,7 @@ async function main() {
             console.log(USAGE);
         return;
     }
-    if (!['new', 'init', 'add', 'ui', 'doctor'].includes(command)) {
+    if (!['new', 'init', 'add', 'ui', 'upgrade', 'doctor'].includes(command)) {
         if (json)
             writeCliError(new Error(`Unknown command: ${command}`), 'UNKNOWN_COMMAND', true);
         else {
@@ -114,8 +114,9 @@ async function main() {
             const options = buildOptionsForRoot(parseCli(promptedArgs), request.directory);
             phase = 'execute';
             await scaffoldProject(options);
-            if (!options.json && !options.dryRun)
-                console.log(`\nCreated ${options.rootDirectory}\nRun: cd ${options.rootDirectory} && pnpm dev`);
+            if (!options.json && !options.dryRun) {
+                console.log(`\nCreated ${options.rootDirectory}\nNext: cd ${options.rootDirectory}\nThen follow README.md to configure the selected providers and start the app.`);
+            }
         }
         else if (command === 'doctor') {
             const unknown = rawArgs.filter((arg) => !['--json', '--verbose'].includes(arg));
@@ -146,6 +147,17 @@ async function main() {
             phase = 'execute';
             await scaffoldUiComponents(options);
         }
+        else if (command === 'upgrade') {
+            const unknown = rawArgs.filter((arg) => !['--skip-install', '--dry-run', '--json', '--verbose'].includes(arg));
+            if (unknown.length)
+                throw new Error(`Unknown upgrade option: ${unknown[0]}`);
+            phase = 'execute';
+            await scaffoldUpgradeProject({
+                skipInstall: rawArgs.includes('--skip-install'),
+                dryRun: rawArgs.includes('--dry-run'),
+                json,
+            });
+        }
         else {
             const options = buildOptions(parseCli(await promptForInitModules(rawArgs)));
             phase = 'execute';

package/dist/cli.d.ts

@@ -1,14 +1,14 @@
 import type { AddOptions, InitOptions } from './scaffold.js';
 import { type NativeStylingLibrary } from './ui.js';
 import type { UiAddOptions } from './scaffold.js';
-export declare const USAGE = "\nanhedral new <directory> [modules...] [--ui <components>] [--native-styling <nativewind|uniwind>] [--toolchain <latest|stable>] [--skip-install] [--dry-run] [--json] [--verbose]\nanhedral init [modules...] [--ui <components>] [--native-styling <nativewind|uniwind>] [--toolchain <latest|stable>] [--skip-install] [--dry-run] [--json] [--verbose]\nanhedral add <module...> [--skip-install] [--dry-run] [--json] [--verbose]\nanhedral ui add <component...> [--target <client>] [--skip-install] [--dry-run] [--json] [--verbose]\nanhedral doctor [--json] [--verbose]\nanhedral --version\n\nCommands:\n  anhedral new my-app\n    Generate the complete TypeScript stack in a new directory. With no module flags, every module is included.\n  anhedral new my-app --web --api --db --auth\n    Generate a web app, Fastify API, shared database package, and auth wiring.\n  anhedral init --web --api --db --auth\n    Generate the same readable workspace in the current empty directory.\n  anhedral add mobile extension\n    Add missing modules to an existing Anhedral project.\n  anhedral ui add button dialog --target mobile\n    Add React Native Reusables components to Expo. DOM clients use shadcn/ui.\n";
+export declare const USAGE = "\nanhedral new <directory> [modules...] [--ui <components>] [--native-styling <nativewind|uniwind>] [--toolchain <latest|stable>] [--skip-install] [--dry-run] [--json] [--verbose]\nanhedral init [modules...] [--ui <components>] [--native-styling <nativewind|uniwind>] [--toolchain <latest|stable>] [--skip-install] [--dry-run] [--json] [--verbose]\nanhedral add <module...> [--skip-install] [--dry-run] [--json] [--verbose]\nanhedral ui add <component...> [--target <client>] [--skip-install] [--dry-run] [--json] [--verbose]\nanhedral upgrade [--skip-install] [--dry-run] [--json] [--verbose]\nanhedral doctor [--json] [--verbose]\nanhedral --version\n\nCommands:\n  anhedral new my-app\n    Generate the complete TypeScript stack in a new directory. With no module flags, every module is included.\n  anhedral new my-app --web --api --db --auth\n    Generate a web app, Fastify API, shared database package, and auth wiring.\n  anhedral init --web --api --db --auth\n    Generate the same readable workspace in the current empty directory.\n  anhedral add mobile extension\n    Add missing modules to an existing Anhedral project.\n  anhedral ui add button dialog --target mobile\n    Add React Native Reusables components to Expo. DOM clients use shadcn/ui.\n  anhedral upgrade\n    Transactionally upgrade a supported older Anhedral project before adding modules.\n";
 export type NewProjectRequest = {
     readonly directory: string;
     readonly moduleArgs: readonly string[];
 };
 export declare function parseNewProjectRequest(args: readonly string[]): NewProjectRequest;
 export declare const APP_MODULES: readonly ["web", "mobile", "api", "desktop", "extension"];
-export declare const FEATURE_MODULES: readonly ["db", "auth", "billing", "storage", "native-subscriptions"];
+export declare const FEATURE_MODULES: readonly ["db", "auth", "billing", "storage", "native-subscriptions", "electron-updater"];
 export type AppModule = (typeof APP_MODULES)[number];
 export type FeatureModule = (typeof FEATURE_MODULES)[number];
 export type SupportedModule = AppModule | FeatureModule;

package/dist/cli.js

@@ -9,6 +9,7 @@ anhedral new <directory> [modules...] [--ui <components>] [--native-styling <nat
 anhedral init [modules...] [--ui <components>] [--native-styling <nativewind|uniwind>] [--toolchain <latest|stable>] [--skip-install] [--dry-run] [--json] [--verbose]
 anhedral add <module...> [--skip-install] [--dry-run] [--json] [--verbose]
 anhedral ui add <component...> [--target <client>] [--skip-install] [--dry-run] [--json] [--verbose]
+anhedral upgrade [--skip-install] [--dry-run] [--json] [--verbose]
 anhedral doctor [--json] [--verbose]
 anhedral --version
 
@@ -23,6 +24,8 @@ Commands:
     Add missing modules to an existing Anhedral project.
   anhedral ui add button dialog --target mobile
     Add React Native Reusables components to Expo. DOM clients use shadcn/ui.
+  anhedral upgrade
+    Transactionally upgrade a supported older Anhedral project before adding modules.
 `;
 export function parseNewProjectRequest(args) {
     const [directory, ...moduleArgs] = args;
@@ -31,7 +34,7 @@ export function parseNewProjectRequest(args) {
     return Object.freeze({ directory, moduleArgs: Object.freeze(moduleArgs) });
 }
 export const APP_MODULES = ['web', 'mobile', 'api', 'desktop', 'extension'];
-export const FEATURE_MODULES = ['db', 'auth', 'billing', 'storage', 'native-subscriptions'];
+export const FEATURE_MODULES = ['db', 'auth', 'billing', 'storage', 'native-subscriptions', 'electron-updater'];
 export function parseCli(args) {
     const flags = { modules: new Set(), uiComponents: [] };
     for (let index = 0; index < args.length; index += 1) {

package/dist/composers/root.js

@@ -17,6 +17,7 @@ const ROOT_ENVIRONMENT_ORDER = [
     'R2_BUCKET_NAME',
     'R2_PREFIX',
     'R2_PROXY_READ_URL_TTL_SECONDS',
+    'DESKTOP_UPDATE_BASE_URL',
     'CLOUDFLARE_API_TOKEN',
     'CRON_SECRET',
 ];

package/dist/dependencies.d.ts

@@ -29,6 +29,7 @@ export declare const MOBILE_NATIVEWIND_DEPENDENCIES: DependencyGroup;
 export declare const MOBILE_UNIWIND_DEPENDENCIES: DependencyGroup;
 export declare const WEB_APP_DEPENDENCIES: DependencyGroup;
 export declare const DESKTOP_DEPENDENCIES: DependencyGroup;
+export declare const ELECTRON_UPDATER_DEPENDENCIES: DependencyGroup;
 export declare function dependencyManifest(): {
     verifiedAt: string;
     packageManager: string;
@@ -54,4 +55,5 @@ export declare function dependencyManifest(): {
     mobileUniwind: DependencyGroup;
     webApp: DependencyGroup;
     desktop: DependencyGroup;
+    electronUpdater: DependencyGroup;
 };

package/dist/dependencies.js

@@ -264,7 +264,7 @@ export const WEB_APP_DEPENDENCIES = {
         // renovate: datasource=npm depName=@clerk/ui
         '@clerk/ui': '1.25.3',
         // renovate: datasource=npm depName=next
-        next: '16.2.10',
+        next: '16.2.11',
         // renovate: datasource=npm depName=react
         react: EXTENSION_DEPENDENCIES.dependencies.react,
         // renovate: datasource=npm depName=react-dom
@@ -322,6 +322,12 @@ export const DESKTOP_DEPENDENCIES = {
         vite: '7.3.6',
     },
 };
+export const ELECTRON_UPDATER_DEPENDENCIES = {
+    dependencies: {
+        // renovate: datasource=npm depName=electron-updater
+        'electron-updater': '6.8.9',
+    },
+};
 export function dependencyManifest() {
     return {
         verifiedAt: VERIFIED_AT,
@@ -341,5 +347,6 @@ export function dependencyManifest() {
         mobileUniwind: MOBILE_UNIWIND_DEPENDENCIES,
         webApp: WEB_APP_DEPENDENCIES,
         desktop: DESKTOP_DEPENDENCIES,
+        electronUpdater: ELECTRON_UPDATER_DEPENDENCIES,
     };
 }

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { APP_MODULES, FEATURE_MODULES, USAGE, buildAddOptions, buildOptions, deriveDisplayName, deriveProjectName, normalizeModuleName, parseCli, parseNewProjectRequest, buildOptionsForRoot, parseUiAddOptions, } from './cli.js';
 export type { AppModule, FeatureModule, ParsedFlags, SupportedModule } from './cli.js';
-export { doctorProject, scaffoldAddModules, scaffoldProject, scaffoldUiComponents, } from './scaffold.js';
-export type { AddOptions, DoctorIssue, DoctorReport, InitOptions, ProjectOptions, UiAddOptions, } from './scaffold.js';
+export { doctorProject, isSupportedProjectUpgrade, scaffoldAddModules, scaffoldProject, scaffoldUiComponents, scaffoldUpgradeProject, } from './scaffold.js';
+export type { AddOptions, DoctorIssue, DoctorReport, InitOptions, ProjectOptions, UiAddOptions, UpgradeOptions, } from './scaffold.js';
 export * from './architecture/index.js';
 export { BundledTemplateSource, assertTemplateProvenance, hashTemplateDirectory, materializeTemplates, templateIdsForModules, } from './template-source.js';
 export type { TemplateMaterializeRequest, TemplateSource, } from './template-source.js';

package/dist/index.js

@@ -1,5 +1,5 @@
 export { APP_MODULES, FEATURE_MODULES, USAGE, buildAddOptions, buildOptions, deriveDisplayName, deriveProjectName, normalizeModuleName, parseCli, parseNewProjectRequest, buildOptionsForRoot, parseUiAddOptions, } from './cli.js';
-export { doctorProject, scaffoldAddModules, scaffoldProject, scaffoldUiComponents, } from './scaffold.js';
+export { doctorProject, isSupportedProjectUpgrade, scaffoldAddModules, scaffoldProject, scaffoldUiComponents, scaffoldUpgradeProject, } from './scaffold.js';
 export * from './architecture/index.js';
 export { BundledTemplateSource, assertTemplateProvenance, hashTemplateDirectory, materializeTemplates, templateIdsForModules, } from './template-source.js';
 export { GENERATOR_VERSION } from './version.js';

package/dist/prompts.d.ts

@@ -2,4 +2,4 @@ export declare function shouldPromptForInitModules(args: readonly string[], isTT
 export declare function hasUiSelection(args: readonly string[]): boolean;
 export declare function parsePromptModules(input: string, fallback: readonly string[]): string[];
 export declare const DEFAULT_PROMPT_APP_MODULES: readonly ["web", "mobile", "api", "desktop", "extension"];
-export declare const DEFAULT_PROMPT_FEATURE_MODULES: readonly ["db", "auth", "billing", "storage", "native-subscriptions"];
+export declare const DEFAULT_PROMPT_FEATURE_MODULES: readonly ["db", "auth", "billing", "storage", "native-subscriptions", "electron-updater"];

package/dist/scaffold.d.ts

@@ -14,6 +14,7 @@ export type FeatureSelections = {
     billing: boolean;
     storage: boolean;
     nativeSubscriptions: boolean;
+    electronUpdater: boolean;
 };
 export interface InitOptions {
     projectName: string;
@@ -42,6 +43,11 @@ export interface UiAddOptions {
     dryRun: boolean;
     json: boolean;
 }
+export interface UpgradeOptions {
+    skipInstall: boolean;
+    dryRun: boolean;
+    json: boolean;
+}
 export interface ProjectOptions {
     projectName: string;
     displayName: string;
@@ -62,7 +68,9 @@ export type DoctorReport = {
     generatorVersion: string;
     issues: DoctorIssue[];
 };
+export declare function isSupportedProjectUpgrade(fromVersion: string, toVersion: string): boolean;
 export declare function scaffoldProject(inputOptions: InitOptions): Promise<void>;
 export declare function scaffoldUiComponents(uiOptions: UiAddOptions): Promise<void>;
+export declare function scaffoldUpgradeProject(upgradeOptions: UpgradeOptions): Promise<void>;
 export declare function scaffoldAddModules(addOptions: AddOptions): Promise<void>;
 export declare function doctorProject(): DoctorReport;