@pipelab/shared 1.0.0-beta.1 → 1.0.0-beta.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipelab/shared",
-  "version": "1.0.0-beta.1",
+  "version": "1.0.0-beta.11",
   "private": false,
   "description": "Shared logic and types for the Pipelab ecosystem",
   "license": "FSL-1.1-MIT",
@@ -37,17 +37,21 @@
     "tslog": "4.9.3",
     "type-fest": "4.26.1",
     "valibot": "0.42.1",
-    "@pipelab/migration": "1.0.0-beta.1"
+    "@pipelab/constants": "1.0.0-beta.13",
+    "@pipelab/migration": "1.0.0-beta.11"
   },
   "devDependencies": {
     "esbuild-plugin-wasm": "1.1.0",
     "tsdown": "0.21.2",
     "typescript": "5.9.3",
-    "@pipelab/tsconfig": "1.0.0-beta.1"
+    "vitest": "3.1.4",
+    "@pipelab/tsconfig": "1.0.0-beta.11"
   },
   "scripts": {
     "build": "tsdown",
     "format": "oxfmt .",
-    "lint": "oxlint ."
+    "lint": "oxlint .",
+    "typecheck": "tsc -b",
+    "test": "vitest run"
   }
 }

package/src/apis.ts

@@ -98,24 +98,13 @@ export type IpcDefinition = {
       | EndEvent<{ outputs: Record<string, unknown>; tmp: string }>
     ),
   ];
-  "condition:execute": [
-    {
-      pluginId: string;
-      nodeId: string;
-      params: any;
-      steps: Steps;
-    },
-    (
-      | Event<"progress", unknown>
-      | Event<"progress", unknown>
-      | EndEvent<{ outputs: Record<string, unknown>; value: boolean }>
-    ),
-  ];
+
   "constants:get": [void, EndEvent<{ result: { userData: string } }>];
 
   "config:load": [{ config: string }, EndEvent<{ result: any }>];
   "config:save": [{ data: any; config: string }, EndEvent<{ result: "ok" }>];
   "config:reset": [{ config: string; key: string }, EndEvent<{ result: "ok" }>];
+  "config:delete": [{ config: string }, EndEvent<{ result: "ok" }>];
   "action:cancel": [void, EndEvent<{ result: "ok" | "ko" }>];
 
   // Build History APIs
@@ -173,6 +162,44 @@ export type IpcDefinition = {
   ];
   "agent:version:get": [void, EndEvent<{ version: string }>];
   "startup:progress": [void, { type: "progress"; data: { message: string } } | { type: "ready" }];
+  "plugin:loaded": [void, { plugin: RendererPluginDefinition }];
+  "plugin:search": [
+    { query: string },
+    EndEvent<{
+      results: Array<{
+        name: string;
+        version: string;
+        description?: string;
+        keywords?: string[];
+        date?: string;
+      }>;
+    }>,
+  ];
+  "plugin:get-details": [
+    { packageName: string },
+    EndEvent<{
+      name: string;
+      latestVersion: string;
+      versions: string[];
+      description?: string;
+    }>,
+  ];
+  "plugin:install": [{ packageName: string; version: string }, EndEvent<{ result: "ok" }>];
+  "plugin:uninstall": [{ packageName: string }, EndEvent<{ result: "ok" }>];
+  "plugin:list-installed": [
+    void,
+    EndEvent<{
+      installed: Array<{
+        name: string;
+        version: string;
+        description?: string;
+      }>;
+    }>,
+  ];
+  "plugin:ensure-loaded": [
+    { plugins: Record<string, string> },
+    EndEvent<{ loaded: string[]; failed: string[] }>,
+  ];
 };
 
 export type Channels = keyof IpcDefinition;

package/src/build-history.ts

@@ -1,4 +1,5 @@
 // Build History Storage Types and Interfaces
+import { SandboxFolder } from "@pipelab/constants";
 
 export interface ExecutionStep {
   id: string;
@@ -86,6 +87,7 @@ export interface IBuildHistoryStorage {
       total: number;
       free: number;
       pipelab: number;
+      folders: Array<{ name: SandboxFolder; label: string; size: number }>;
     };
   }>;
 }

package/src/config/connections-definition.ts

@@ -0,0 +1,3 @@
+import type { ConnectionsConfig, ConnectionsConfigV1, Connection } from "../config.schema";
+
+export type { ConnectionsConfig, ConnectionsConfigV1, Connection };

package/src/config/migrators.ts

@@ -1,10 +1,11 @@
 import {
-  createMigration,
+  createMigration as createMigrationBase,
   createMigrator,
   finalVersion,
-  initialVersion,
   OmitVersion,
   SemVer,
+  Awaitable,
+  MigrationSchema,
 } from "@pipelab/migration";
 import {
   AppConfig,
@@ -15,12 +16,51 @@ import {
   AppConfigV5,
   AppConfigV6,
   AppConfigV7,
+  AppConfigV8,
+  ConnectionsConfig,
+  ConnectionsConfigV1,
 } from "../config.schema";
+
+const DEFAULT_PLUGINS: AppConfigV8["plugins"] = [
+  {
+    name: "@pipelab/plugin-construct",
+    enabled: true,
+    description: "Construct 3 export & packaging",
+  },
+  { name: "@pipelab/plugin-filesystem", enabled: true, description: "Filesystem utilities" },
+  { name: "@pipelab/plugin-system", enabled: true, description: "System & shell commands" },
+  { name: "@pipelab/plugin-steam", enabled: true, description: "Steam publishing" },
+  { name: "@pipelab/plugin-itch", enabled: true, description: "Itch.io publishing" },
+  { name: "@pipelab/plugin-electron", enabled: true, description: "Electron packaging" },
+  { name: "@pipelab/plugin-discord", enabled: true, description: "Discord Rich Presence" },
+  { name: "@pipelab/plugin-poki", enabled: true, description: "Poki publishing" },
+  { name: "@pipelab/plugin-nvpatch", enabled: true, description: "NW.js patching" },
+  { name: "@pipelab/plugin-tauri", enabled: true, description: "Tauri packaging" },
+  { name: "@pipelab/plugin-minify", enabled: true, description: "Asset minification" },
+  { name: "@pipelab/plugin-netlify", enabled: true, description: "Netlify deployment" },
+];
 import { FileRepoV1, FileRepoV2, FileRepo } from "./projects-types";
-import { SavedFileV1, SavedFileV2, SavedFileV3, SavedFileV4, SavedFile } from "../model";
+import {
+  SavedFileV1,
+  SavedFileV2,
+  SavedFileV3,
+  SavedFileV4,
+  SavedFileV5,
+  SavedFile,
+} from "../model";
 
 // --- Types ---
 
+export type Additive<T, P> = OmitVersion<T> & OmitVersion<P>;
+
+type DistributiveOmit<T, K extends keyof any> = T extends any ? Omit<T, K> : never;
+type DistributiveOmitVersion<T> = DistributiveOmit<T, keyof MigrationSchema>;
+
+const createMigration = <From extends MigrationSchema, To extends MigrationSchema>(config: {
+  version: SemVer;
+  up: (state: OmitVersion<From>, targetVersion: string) => Awaitable<OmitVersion<To>>;
+}) => createMigrationBase<From, To>(config);
+
 export interface Migrator<T> {
   migrate: (data: any, options?: any) => Promise<T>;
   defaultValue: T;
@@ -31,11 +71,9 @@ export interface Migrator<T> {
 const settingsMigratorInternal = createMigrator<AppConfigV1, AppConfig>();
 
 export const defaultAppSettings = settingsMigratorInternal.createDefault({
-  cacheFolder: "",
-  clearTemporaryFoldersOnPipelineEnd: false,
   locale: "en-US",
   theme: "light",
-  version: "7.0.0" as SemVer,
+  version: "8.0.0",
   autosave: true,
   agents: [],
   tours: {
@@ -48,40 +86,41 @@ export const defaultAppSettings = settingsMigratorInternal.createDefault({
       completed: false,
     },
   },
+  buildHistory: {
+    retentionPolicy: {
+      enabled: false,
+      maxEntries: 50,
+      maxAge: 30,
+    },
+  },
+  plugins: DEFAULT_PLUGINS,
+  isInternalMigrationBannerClosed: false,
 });
 
 export const appSettingsMigrator = settingsMigratorInternal.createMigrations({
   defaultValue: defaultAppSettings,
   migrations: [
-    createMigration<never, AppConfigV1, AppConfigV2>({
+    createMigration<AppConfigV1, AppConfigV2>({
       version: "1.0.0" as SemVer,
-      up: (state) => state satisfies OmitVersion<AppConfigV2>,
-      down: initialVersion,
+      up: (state) => state,
     }),
-    createMigration<AppConfigV1, AppConfigV2, AppConfigV3>({
+    createMigration<AppConfigV2, AppConfigV3>({
       version: "2.0.0" as SemVer,
       up: (state) => {
         return {
           ...state,
           clearTemporaryFoldersOnPipelineEnd: false,
-        } satisfies OmitVersion<AppConfigV3>;
-      },
-      down: () => {
-        throw new Error("Can't migrate down from 2.0.0");
+        };
       },
     }),
-    createMigration<AppConfigV2, AppConfigV3, AppConfigV4>({
+    createMigration<AppConfigV3, AppConfigV4>({
       version: "3.0.0" as SemVer,
       up: (state) => ({
         ...state,
         locale: "en-US" as const,
       }),
-      down: (state) => {
-        const { locale, ...rest } = state as AppConfigV4;
-        return rest as unknown as AppConfigV3;
-      },
     }),
-    createMigration<AppConfigV3, AppConfigV4, AppConfigV5>({
+    createMigration<AppConfigV4, AppConfigV5>({
       version: "4.0.0" as SemVer,
       up: (state) => ({
         ...state,
@@ -96,39 +135,55 @@ export const appSettingsMigrator = settingsMigratorInternal.createMigrations({
           },
         },
       }),
-      down: (state) => {
-        const { tours, ...rest } = state as AppConfigV5;
-        return rest as unknown as AppConfigV4;
-      },
     }),
-    createMigration<AppConfigV4, AppConfigV5, AppConfigV6>({
+    createMigration<AppConfigV5, AppConfigV6>({
       version: "5.0.0" as SemVer,
       up: (state) => ({
         ...state,
         autosave: true,
       }),
-      down: (state) => {
-        const { autosave, ...rest } = state as AppConfigV6;
-        return rest as unknown as AppConfigV5;
-      },
     }),
-    createMigration<AppConfigV5, AppConfigV6, AppConfigV7>({
+    createMigration<AppConfigV6, AppConfigV8>({
       version: "6.0.0" as SemVer,
-      up: (state) => ({
-        ...state,
-        agents: [],
-      }),
-      down: (state) => {
-        const { agents, ...rest } = state as AppConfigV7;
-        return rest as unknown as AppConfigV6;
+      up: (state) => {
+        const { cacheFolder: _, clearTemporaryFoldersOnPipelineEnd: __, ...rest } = state;
+        return {
+          ...rest,
+          agents: [],
+          buildHistory: {
+            retentionPolicy: {
+              enabled: false,
+              maxEntries: 50,
+              maxAge: 30,
+            },
+          },
+          plugins: DEFAULT_PLUGINS,
+          isInternalMigrationBannerClosed: false,
+        };
       },
     }),
-    createMigration<AppConfigV6, AppConfigV7, never>({
-      version: "7.0.0" as SemVer,
+    createMigration<AppConfigV8, never>({
+      version: "8.0.0" as SemVer,
+      up: finalVersion,
+    }),
+  ],
+});
+
+// --- Connections Migrator ---
+
+const connectionsMigratorInternal = createMigrator<ConnectionsConfigV1, ConnectionsConfig>();
+
+export const defaultConnections = connectionsMigratorInternal.createDefault({
+  version: "1.0.0",
+  connections: [],
+});
+
+export const connectionsMigrator = connectionsMigratorInternal.createMigrations({
+  defaultValue: defaultConnections,
+  migrations: [
+    createMigration<ConnectionsConfigV1, never>({
+      version: "1.0.0" as SemVer,
       up: finalVersion,
-      down: () => {
-        throw new Error("Can't migrate down from 7.0.0");
-      },
     }),
   ],
 });
@@ -147,13 +202,12 @@ export const defaultFileRepo = fileRepoMigratorInternal.createDefault({
     },
   ],
   pipelines: [],
-  proxies: [],
 });
 
 export const fileRepoMigrations = fileRepoMigratorInternal.createMigrations({
   defaultValue: defaultFileRepo,
   migrations: [
-    createMigration<never, FileRepoV1, FileRepoV2>({
+    createMigration<FileRepoV1, FileRepoV2>({
       version: "1.0.0",
       up: (state) => {
         const pipelines: FileRepoV2["pipelines"] = Object.entries(state.data || {}).map(
@@ -166,7 +220,7 @@ export const fileRepoMigrations = fileRepoMigratorInternal.createMigrations({
           },
         );
         return {
-          version: "2.0.0",
+          ...state,
           projects: [
             {
               id: "main",
@@ -175,17 +229,12 @@ export const fileRepoMigrations = fileRepoMigratorInternal.createMigrations({
             },
           ],
           pipelines: pipelines,
-          proxies: [],
-        } as any;
+        };
       },
-      down: initialVersion,
     }),
-    createMigration<FileRepoV1, FileRepoV2, never>({
+    createMigration<FileRepoV2, never>({
       version: "2.0.0",
       up: finalVersion,
-      down: (state) => {
-        throw new Error("Cannot downgrade to version 1.0.0");
-      },
     }),
   ],
 });
@@ -201,20 +250,19 @@ const savedFileDefaultValue = savedFileMigratorInternal.createDefault({
   description: "",
   name: "",
   variables: [],
-  type: "default",
-  version: "4.0.0" as SemVer,
+  version: "5.0.0",
 });
 
 export const savedFileMigrator = savedFileMigratorInternal.createMigrations({
   defaultValue: savedFileDefaultValue,
   migrations: [
-    createMigration<never, SavedFileV1, SavedFileV2>({
+    createMigration<SavedFileV1, SavedFileV2>({
       version: "1.0.0" as SemVer,
       up: (state) => {
         const blocks = state.canvas.blocks;
 
-        const triggers: any[] = [];
-        const newBlocks: any[] = [];
+        const triggers: SavedFileV2["canvas"]["triggers"] = [];
+        const newBlocks: SavedFileV2["canvas"]["blocks"] = [];
 
         for (const block of blocks) {
           if (block.type === "event") {
@@ -225,27 +273,25 @@ export const savedFileMigrator = savedFileMigratorInternal.createMigrations({
         }
 
         return {
+          ...state,
           canvas: {
+            ...state.canvas,
             blocks: newBlocks,
             triggers: triggers,
           },
-          description: state.description,
-          name: state.name,
-          variables: state.variables,
-        } as any;
+        };
       },
-      down: initialVersion,
     }),
-    createMigration<SavedFileV1, SavedFileV2, SavedFileV3>({
+    createMigration<SavedFileV2, SavedFileV3>({
       version: "2.0.0" as SemVer,
       up: (state) => {
-        const { canvas, ...rest } = state;
+        const { canvas } = state;
         const { blocks, triggers } = canvas;
 
-        const newBlocks: any[] = [];
+        const newBlocks: SavedFileV3["canvas"]["blocks"] = [];
 
         for (const block of blocks) {
-          const newParams: any = {};
+          const newParams: SavedFileV3["canvas"]["blocks"][number]["params"] = {};
 
           for (const data of Object.entries(block.params)) {
             if (data === undefined) {
@@ -266,43 +312,139 @@ export const savedFileMigrator = savedFileMigratorInternal.createMigrations({
         }
 
         return {
-          ...rest,
+          ...state,
           canvas: {
+            ...canvas,
             triggers,
             blocks: newBlocks,
           },
-        } as any;
-      },
-      down: () => {
-        throw new Error("Migration down not implemented");
+        };
       },
     }),
-    createMigration<SavedFileV2, SavedFileV3, SavedFileV4>({
+    createMigration<SavedFileV3, SavedFileV4>({
       version: "3.0.0" as SemVer,
-      up: (state) => {
-        return {
-          ...state,
-          type: "default",
-        } as any;
-      },
-      down: () => {
-        throw new Error("Migration down not implemented");
-      },
+      up: (state) => ({
+        ...state,
+        type: "default",
+      }),
     }),
-    createMigration<SavedFileV3, SavedFileV4, SavedFileV4>({
+    createMigration<SavedFileV4, SavedFileV5>({
       version: "4.0.0" as SemVer,
-      up: finalVersion,
-      down: () => {
-        throw new Error("Migration down not implemented");
+      up: (_state) => {
+        const state = _state as DistributiveOmitVersion<SavedFileV4>;
+        if (state.type === "simple") {
+          return {
+            name: state.name,
+            description: state.description,
+            canvas: {
+              blocks: [],
+              triggers: [],
+            },
+            variables: [],
+          };
+        }
+
+        const migrateBlock = (block: any, pluginsMap: Record<string, string>) => {
+          if (!block) return;
+          if (block.origin?.pluginId) {
+            block.origin.pluginId = getStrictPluginId(block.origin.pluginId);
+            // Stamp the version from the old top-level plugins map, falling back to "latest"
+            block.origin.version = pluginsMap[block.origin.pluginId] ?? "latest";
+          }
+        };
+
+        // Normalise the old plugins map's keys first so lookups are consistent
+        const normalizedPlugins: Record<string, string> = {};
+        if (state.plugins) {
+          for (const [key, val] of Object.entries(state.plugins)) {
+            normalizedPlugins[getStrictPluginId(key)] = val;
+          }
+        }
+
+        // Stamp origin.version on every block and trigger
+        if (state.canvas) {
+          for (const block of state.canvas.blocks ?? []) {
+            migrateBlock(block, normalizedPlugins);
+          }
+          for (const trigger of state.canvas.triggers ?? []) {
+            migrateBlock(trigger, normalizedPlugins);
+          }
+        }
+
+        // Drop the top-level plugins map — version is now per-block. Omit type.
+        const { plugins: _dropped, type: _type, ...rest } = state;
+        return rest;
       },
     }),
+    createMigration<SavedFileV5, never>({
+      version: "5.0.0" as SemVer,
+      up: finalVersion,
+    }),
   ],
 });
 
+const LEGACY_ID_MAP: Record<string, string> = {
+  construct: "@pipelab/plugin-construct",
+  filesystem: "@pipelab/plugin-filesystem",
+  system: "@pipelab/plugin-system",
+  steam: "@pipelab/plugin-steam",
+  itch: "@pipelab/plugin-itch",
+  electron: "@pipelab/plugin-electron",
+  discord: "@pipelab/plugin-discord",
+  dicord: "@pipelab/plugin-discord",
+  "@pipelab/plugin-dicord": "@pipelab/plugin-discord",
+  poki: "@pipelab/plugin-poki",
+  nvpatch: "@pipelab/plugin-nvpatch",
+  tauri: "@pipelab/plugin-tauri",
+  minify: "@pipelab/plugin-minify",
+  netlify: "@pipelab/plugin-netlify",
+};
+
+export const getStrictPluginId = (pluginId: string): string => {
+  if (!pluginId) return pluginId;
+  return LEGACY_ID_MAP[pluginId] || pluginId;
+};
+
+const normalizeBlockPluginId = (block: any): boolean => {
+  if (!block) return false;
+  let changed = false;
+  if (block.origin?.pluginId) {
+    const strictId = getStrictPluginId(block.origin.pluginId);
+    if (block.origin.pluginId !== strictId) {
+      block.origin.pluginId = strictId;
+      changed = true;
+    }
+  }
+  return changed;
+};
+
+export const normalizePipelineConfig = (state: any): boolean => {
+  if (!state) return false;
+  let changed = false;
+
+  // Normalise plugin IDs in block and trigger origins (pluginId field only;
+  // version strings don't need normalisation)
+  if (state.type === "default" && state.canvas) {
+    if (Array.isArray(state.canvas.blocks)) {
+      for (const block of state.canvas.blocks) {
+        if (normalizeBlockPluginId(block)) changed = true;
+      }
+    }
+    if (Array.isArray(state.canvas.triggers)) {
+      for (const trigger of state.canvas.triggers) {
+        if (normalizeBlockPluginId(trigger)) changed = true;
+      }
+    }
+  }
+
+  return changed;
+};
+
 // --- Registry ---
 
 export const configRegistry: Record<string, Migrator<any>> = {
   settings: appSettingsMigrator,
   projects: fileRepoMigrations,
   pipeline: savedFileMigrator,
+  connections: connectionsMigrator,
 };

package/src/config/settings-definition.ts

@@ -7,6 +7,7 @@ import type {
   AppConfigV5,
   AppConfigV6,
   AppConfigV7,
+  AppConfigV8,
 } from "../config.schema";
 
 export type {
@@ -18,4 +19,5 @@ export type {
   AppConfigV5,
   AppConfigV6,
   AppConfigV7,
+  AppConfigV8,
 };