@n8n-as-code/manager-adapter 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,108 @@
+import { getN8nManagerAgentInstructions, type EffectiveN8nContext, type GlobalN8nInstance, type N8nGlobalConfiguration, type N8nSyncFolderDefaultPolicy, type UpsertGlobalN8nInstanceInput, type N8nHealthSnapshot, type N8nInstanceRef, type N8nRuntimeConsumer, type N8nRuntimeStatusSnapshot, type N8nInstanceAccessSnapshot, type ResolveN8nInstanceAccessInput, type PreparedEffectiveN8nContext, type N8nWorkspaceOverrides, type WorkflowWebviewOpenPayload, type N8nProjectSnapshot } from '@n8n-as-code/n8n-manager-core';
+export { getN8nManagerAgentInstructions };
+import { type CredentialCatalogEntry, type CredentialInventory, type CredentialRecipe, type CredentialTestResult, type EnsureCredentialInput, type N8nCredentialRef, type StarterKit, type StarterKitResult } from '@n8n-as-code/n8n-credentials-manager';
+import { N8N_FACADE_SETUP_MODES, type N8nFacadeSetupMode } from '@n8n-as-code/workflow-core';
+export interface N8nManagerFacadeOptions {
+    n8nHost?: string;
+    n8nApiKey?: string;
+    projectId?: string;
+    statePath?: string;
+    workspaceRoot?: string;
+}
+export interface N8nFacadeSetupInput {
+    mode: N8nFacadeSetupMode;
+    instanceId?: string;
+    instanceName?: string;
+    n8nHost?: string;
+    n8nApiKeyRef?: string;
+    tunnel?: boolean;
+    bootstrapOwner?: boolean;
+}
+export interface N8nManagerFacade {
+    setup(input: N8nFacadeSetupInput): Promise<N8nInstanceRef>;
+    getManagedOwnerCredentials(instanceId: string): Promise<{
+        username: string;
+        password: string;
+    } | undefined>;
+    status(input?: {
+        instanceId?: string;
+    }): Promise<N8nRuntimeStatusSnapshot | N8nHealthSnapshot>;
+    startInstance(instanceId: string): Promise<N8nRuntimeStatusSnapshot>;
+    stopInstance(instanceId: string): Promise<N8nRuntimeStatusSnapshot>;
+    restartInstance(instanceId: string): Promise<N8nRuntimeStatusSnapshot>;
+    getManagedInstance(): Promise<N8nInstanceRef | undefined>;
+    listInstances(): Promise<GlobalN8nInstance[]>;
+    getGlobalConfig(): Promise<N8nGlobalConfiguration>;
+    upsertInstance(input: UpsertGlobalN8nInstanceInput, options?: {
+        setActive?: boolean;
+    }): Promise<GlobalN8nInstance>;
+    getGlobalActiveInstance(): Promise<GlobalN8nInstance | undefined>;
+    setGlobalActiveInstance(instanceId: string): Promise<GlobalN8nInstance>;
+    setDefaultSyncFolder(syncFolder: string): Promise<unknown>;
+    deleteInstance(instanceId: string): Promise<{
+        deletedInstance: GlobalN8nInstance;
+        activeInstance?: GlobalN8nInstance;
+    }>;
+    readWorkspaceOverrides(workspaceRoot?: string): Promise<N8nWorkspaceOverrides>;
+    writeWorkspaceOverrides(overrides: Partial<N8nWorkspaceOverrides>, workspaceRoot?: string): Promise<N8nWorkspaceOverrides>;
+    clearWorkspaceOverrides(workspaceRoot?: string): Promise<void>;
+    resolveEffectiveContext(input?: {
+        workspaceRoot?: string;
+        instanceId?: string;
+        requireProject?: boolean;
+        syncFolderDefault?: N8nSyncFolderDefaultPolicy;
+    }): Promise<EffectiveN8nContext>;
+    prepareEffectiveContext(input?: {
+        workspaceRoot?: string;
+        instanceId?: string;
+        requireProject?: boolean;
+        syncFolderDefault?: N8nSyncFolderDefaultPolicy;
+        consumer?: N8nRuntimeConsumer;
+        autoStart?: boolean;
+    }): Promise<PreparedEffectiveN8nContext>;
+    resolveInstanceAccess(input?: ResolveN8nInstanceAccessInput): Promise<N8nInstanceAccessSnapshot>;
+    listProjects(input?: {
+        workspaceRoot?: string;
+        instanceId?: string;
+        syncFolderDefault?: N8nSyncFolderDefaultPolicy;
+        consumer?: N8nRuntimeConsumer;
+        autoStart?: boolean;
+    }): Promise<N8nProjectSnapshot[]>;
+    resolveWorkflowWebviewOpen(input: {
+        workflowId: string;
+        proxyBaseUrl: string;
+        workflowUrl?: string;
+        workspaceRoot?: string;
+        instanceId?: string;
+        routePath?: string;
+    }): Promise<WorkflowWebviewOpenPayload>;
+    listSetupModes(): typeof N8N_FACADE_SETUP_MODES;
+    listCredentialRecipes(): Promise<CredentialRecipe[]>;
+    listCredentialCatalog(): Promise<CredentialCatalogEntry[]>;
+    getCredentialSchema(typeName: string): Promise<Record<string, unknown>>;
+    listCredentials(): Promise<N8nCredentialRef[]>;
+    listStarterKits(): Promise<StarterKit[]>;
+    getCredentialInventory(): Promise<CredentialInventory>;
+    ensureCredentialType(input: {
+        credentialId?: string;
+        credentialName: string;
+        credentialTypeName: string;
+        values: Record<string, unknown>;
+    }): Promise<N8nCredentialRef>;
+    ensureCredential(recipeId: string, input?: EnsureCredentialInput): Promise<N8nCredentialRef>;
+    deleteCredential(credentialIdOrRecipeId: string): Promise<{
+        credentialId?: string;
+        recipeId?: string;
+        deletedRemote: boolean;
+        deletedInventory: boolean;
+    }>;
+    testCredential(credentialIdOrRecipeId: string): Promise<CredentialTestResult>;
+    bootstrapStarterKit(starterKitId: string, inputs?: Record<string, EnsureCredentialInput>): Promise<StarterKitResult>;
+}
+export declare function createN8nManagerFacade(options?: N8nManagerFacadeOptions): N8nManagerFacade;
+export declare function resolveN8nManagerConfigurationPaths(): {
+    homeDir: string;
+    instancesPath: string;
+    secretsPath: string;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,198 @@
+import { FileBackedN8nLifecycleManager, N8nConfigurationService, N8nRuntimeOrchestrator, createManagedLocalLifecycleManager, getN8nManagerAgentInstructions, readFileBackedN8nInstance, resolveWorkflowWebviewOpen, resolveN8nManagerHome, resolveFileBackedN8nStatePath, listN8nProjects, } from '@n8n-as-code/n8n-manager-core';
+export { getN8nManagerAgentInstructions };
+import path from 'node:path';
+import { N8nCredentialsManager, N8nRestCredentialClient, } from '@n8n-as-code/n8n-credentials-manager';
+import { N8N_FACADE_SETUP_MODES, getN8nFacadeSetupMode, } from '@n8n-as-code/workflow-core';
+export function createN8nManagerFacade(options = {}) {
+    const statePath = options.statePath ?? process.env.N8N_MANAGER_STATE_PATH;
+    const lifecycle = new FileBackedN8nLifecycleManager(statePath);
+    const configuration = new N8nConfigurationService();
+    const runtime = new N8nRuntimeOrchestrator({ configuration });
+    async function createCredentialsManager() {
+        if (options.n8nHost && options.n8nApiKey) {
+            return new N8nCredentialsManager({
+                projectId: options.projectId,
+                client: new N8nRestCredentialClient({ baseUrl: options.n8nHost, apiKey: options.n8nApiKey }),
+            });
+        }
+        const prepared = await tryPrepareEffectiveContext(runtime, options.workspaceRoot);
+        const apiBaseUrl = prepared?.context.apiBaseUrl ?? prepared?.context.host;
+        if (apiBaseUrl && prepared?.context.apiKey && !prepared.runtime.blocked) {
+            return new N8nCredentialsManager({
+                projectId: options.projectId ?? prepared.context.projectId,
+                client: new N8nRestCredentialClient({ baseUrl: apiBaseUrl, apiKey: prepared.context.apiKey }),
+            });
+        }
+        const managed = await readFileBackedN8nInstance(statePath);
+        return new N8nCredentialsManager({
+            projectId: options.projectId,
+            client: managed?.baseUrl && managed.apiKey
+                ? new N8nRestCredentialClient({ baseUrl: managed.baseUrl, apiKey: managed.apiKey })
+                : undefined,
+        });
+    }
+    return {
+        async setup(input) {
+            const mode = getN8nFacadeSetupMode(input.mode);
+            const managedRuntime = mode.managerMode === 'managed-local-docker'
+                ? await createManagedLocalLifecycleManager(configuration, {
+                    instanceId: input.instanceId,
+                    name: input.instanceName,
+                })
+                : undefined;
+            const selectedLifecycle = managedRuntime?.lifecycle ?? lifecycle;
+            const selectedStatePath = managedRuntime?.statePath ?? statePath;
+            const instance = await selectedLifecycle.setup({
+                mode: mode.managerMode,
+                baseUrl: input.n8nHost ?? options.n8nHost,
+                apiKeyRef: input.n8nApiKeyRef,
+                tunnel: input.tunnel,
+                bootstrapOwner: input.bootstrapOwner,
+            });
+            const privateInstance = await readFileBackedN8nInstance(selectedStatePath);
+            const lifecycleInstance = {
+                ...instance,
+                ...(privateInstance ?? {}),
+                runtimeStatePath: resolveFileBackedN8nStatePath(selectedStatePath),
+            };
+            configuration.upsertInstanceFromLifecycle(lifecycleInstance, {
+                name: input.instanceName,
+                apiKey: options.n8nApiKey ?? privateInstance?.apiKey,
+                setActive: true,
+            });
+            if (mode.managerMode === 'managed-local-docker' && input.tunnel && instance.tunnelPublicUrl) {
+                const status = await runtime.ensureTunnel(instance.id);
+                return {
+                    ...instance,
+                    warnings: status.warnings,
+                };
+            }
+            return instance;
+        },
+        getManagedOwnerCredentials: async (instanceId) => {
+            const instance = configuration.getInstance(instanceId);
+            if (!instance || instance.mode !== 'managed-local-docker') {
+                return undefined;
+            }
+            const privateState = await readFileBackedN8nInstance(instance.runtimeStatePath);
+            if (!privateState?.ownerEmail || !privateState.ownerPassword) {
+                return undefined;
+            }
+            return {
+                username: privateState.ownerEmail,
+                password: privateState.ownerPassword,
+            };
+        },
+        status: async (input = {}) => {
+            const selected = input.instanceId
+                ? configuration.getInstance(input.instanceId)
+                : configuration.getGlobalActiveInstance();
+            return selected ? runtime.getRuntimeStatus(selected.id) : lifecycle.status();
+        },
+        startInstance: async (instanceId) => runtime.startInstance(instanceId),
+        stopInstance: async (instanceId) => runtime.stopInstance(instanceId),
+        restartInstance: async (instanceId) => runtime.restartInstance(instanceId),
+        getManagedInstance: () => readFileBackedN8nInstance(statePath),
+        listInstances: async () => configuration.listInstances(),
+        getGlobalConfig: async () => configuration.getGlobalConfig(),
+        upsertInstance: async (input, upsertOptions) => configuration.upsertInstance(input, upsertOptions),
+        getGlobalActiveInstance: async () => configuration.getGlobalActiveInstance(),
+        setGlobalActiveInstance: async (instanceId) => configuration.setGlobalActiveInstance(instanceId),
+        setDefaultSyncFolder: async (syncFolder) => configuration.setDefaultSyncFolder(syncFolder),
+        deleteInstance: async (instanceId) => {
+            const instance = configuration.getInstance(instanceId);
+            if (instance?.mode === 'managed-local-docker') {
+                await runtime.cleanupInstanceProcesses(instanceId);
+            }
+            return configuration.deleteInstance(instanceId);
+        },
+        readWorkspaceOverrides: async (workspaceRoot = options.workspaceRoot) => {
+            if (!workspaceRoot)
+                return { version: 3 };
+            return configuration.readWorkspaceOverrides(workspaceRoot);
+        },
+        writeWorkspaceOverrides: async (overrides, workspaceRoot = options.workspaceRoot) => {
+            if (!workspaceRoot)
+                throw new Error('workspaceRoot is required to write n8n workspace overrides.');
+            return configuration.writeWorkspaceOverrides(workspaceRoot, overrides);
+        },
+        clearWorkspaceOverrides: async (workspaceRoot = options.workspaceRoot) => {
+            if (!workspaceRoot)
+                return;
+            configuration.clearWorkspaceOverrides(workspaceRoot);
+        },
+        resolveEffectiveContext: async (input = {}) => configuration.resolveEffectiveContext({
+            workspaceRoot: input.workspaceRoot ?? options.workspaceRoot,
+            instanceId: input.instanceId,
+            requireProject: input.requireProject,
+            syncFolderDefault: input.syncFolderDefault,
+        }),
+        prepareEffectiveContext: async (input = {}) => runtime.prepareEffectiveContext({
+            workspaceRoot: input.workspaceRoot ?? options.workspaceRoot,
+            instanceId: input.instanceId,
+            requireProject: input.requireProject,
+            syncFolderDefault: input.syncFolderDefault,
+            consumer: input.consumer ?? 'plugin',
+            autoStart: input.autoStart,
+        }),
+        resolveInstanceAccess: async (input = {}) => runtime.resolveInstanceAccess({
+            ...input,
+            workspaceRoot: input.workspaceRoot ?? options.workspaceRoot,
+        }),
+        listProjects: async (input = {}) => {
+            const prepared = await runtime.prepareEffectiveContext({
+                workspaceRoot: input.workspaceRoot ?? options.workspaceRoot,
+                instanceId: input.instanceId,
+                syncFolderDefault: input.syncFolderDefault,
+                consumer: input.consumer ?? 'plugin',
+                autoStart: input.autoStart,
+            });
+            if (prepared.runtime.blocked) {
+                throw new Error(prepared.runtime.blocked.message);
+            }
+            const { host, apiKey, activeInstanceName } = prepared.context;
+            if (!host || !apiKey) {
+                throw new Error(`Instance "${activeInstanceName}" needs a host and API key before projects can be loaded.`);
+            }
+            return listN8nProjects({ baseUrl: host, apiKey });
+        },
+        resolveWorkflowWebviewOpen: async (input) => resolveWorkflowWebviewOpen({
+            ...input,
+            workspaceRoot: input.workspaceRoot ?? options.workspaceRoot,
+        }, configuration),
+        listSetupModes: () => N8N_FACADE_SETUP_MODES,
+        listCredentialRecipes: async () => (await createCredentialsManager()).listRecipes(),
+        listCredentialCatalog: async () => (await createCredentialsManager()).listCredentialCatalog(),
+        getCredentialSchema: async (typeName) => (await createCredentialsManager()).getCredentialSchema(typeName),
+        listCredentials: async () => (await createCredentialsManager()).listCredentials(),
+        listStarterKits: async () => (await createCredentialsManager()).listStarterKits(),
+        getCredentialInventory: async () => (await createCredentialsManager()).getCredentialInventory(),
+        ensureCredentialType: async (input) => (await createCredentialsManager()).ensureCredentialType(input),
+        ensureCredential: async (recipeId, input) => (await createCredentialsManager()).ensureCredential(recipeId, input),
+        deleteCredential: async (credentialIdOrRecipeId) => (await createCredentialsManager()).deleteCredential(credentialIdOrRecipeId),
+        testCredential: async (credentialIdOrRecipeId) => (await createCredentialsManager()).testCredential(credentialIdOrRecipeId),
+        bootstrapStarterKit: async (starterKitId, inputs) => (await createCredentialsManager()).bootstrapStarterKit(starterKitId, inputs),
+    };
+}
+export function resolveN8nManagerConfigurationPaths() {
+    const homeDir = resolveN8nManagerHome();
+    return {
+        homeDir,
+        instancesPath: path.join(homeDir, 'instances.json'),
+        secretsPath: path.join(homeDir, 'secrets.json'),
+    };
+}
+async function tryPrepareEffectiveContext(runtime, workspaceRoot) {
+    try {
+        return await runtime.prepareEffectiveContext({
+            workspaceRoot,
+            syncFolderDefault: workspaceRoot ? 'workspace' : 'global',
+            consumer: 'plugin',
+            autoStart: true,
+        });
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@n8n-as-code/manager-adapter",
+  "version": "0.1.0",
+  "description": "Facade adapter from n8n-as-code surfaces to the independent n8n-manager runtime engine",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo"
+  },
+  "dependencies": {
+    "@n8n-as-code/n8n-credentials-manager": "^0.1.2",
+    "@n8n-as-code/n8n-manager-core": "^0.5.0",
+    "@n8n-as-code/workflow-core": "^0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.3"
+  }
+}