@lobb-js/core 0.28.0 → 0.30.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lobb-js/core",
   "license": "UNLICENSED",
-  "version": "0.28.0",
+  "version": "0.30.0",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -37,6 +37,7 @@
     "zod-to-ts": "^1.2.0"
   },
   "devDependencies": {
+    "lucide-svelte": "latest",
     "@types/lodash": "^4.17.0",
     "@types/nunjucks": "^3.2.6",
     "@types/pg": "^8.11.0",

package/src/api/collections/CollectionControllers.ts

@@ -46,12 +46,15 @@ export const collectionControllers: CollectionControllers = {
       });
     }
 
+    const dryRun = c.req.query("dry_run") !== undefined;
+
     const result = await Lobb.instance.collectionService.createOne({
       collectionName,
       context: c,
       data: body.data,
       children: body.children,
       triggeredBy: "API",
+      dryRun,
     });
 
     return c.json(result, 201);
@@ -209,6 +212,8 @@ export const collectionControllers: CollectionControllers = {
       }
     }
 
+    const dryRun = c.req.query("dry_run") !== undefined;
+
     const result = await Lobb.instance.collectionService.updateOne({
       collectionName,
       context: c,
@@ -216,6 +221,7 @@ export const collectionControllers: CollectionControllers = {
       data: body.data,
       children: body.children,
       triggeredBy: "API",
+      dryRun,
     });
     return c.json(result, 200);
   },
@@ -245,12 +251,15 @@ export const collectionControllers: CollectionControllers = {
       }
     }
 
+    const dryRun = c.req.query("dry_run") !== undefined;
+
     const result = await Lobb.instance.collectionService.deleteOne({
       collectionName,
       context: c,
       id,
       force,
       triggeredBy: "API",
+      dryRun,
     });
 
     return c.json(result);

package/src/api/collections/collectionStore.ts

@@ -41,6 +41,16 @@ export class CollectionStore {
     context?: HonoContext;
     client?: PoolClient;
   }): Promise<ExposedManyServiceOutput> {
+    // Resolve children_of + parent_id into a regular filter before proceeding.
+    // This allows fetching related records (fk, m2m, polymorphic) without the caller
+    // needing to know the relation type or junction details.
+    if ((params as any)?.children_of !== undefined) {
+      const { children_of, parent_id, ...rest } = params as any;
+      const childFilter = await this.resolveChildrenOf(collectionName, children_of, parent_id);
+      if (childFilter === null) return { data: [], meta: { totalCount: 0 } };
+      params = { ...rest, filter: { ...rest.filter, ...childFilter } };
+    }
+
     return await beginTransaction(
       async (client) => {
         const eventResult = await Lobb.instance.eventSystem.emit(
@@ -224,6 +234,7 @@ export class CollectionStore {
     triggeredBy = "INTERNAL",
     context,
     client,
+    dryRun = false,
   }: {
     collectionName: string;
     data: Record<string, any>;
@@ -231,6 +242,7 @@ export class CollectionStore {
     triggeredBy?: TriggeredBy;
     context?: HonoContext;
     client?: PoolClient;
+    dryRun?: boolean;
   }): Promise<ExposedServiceOutput> {
     return await beginTransaction(
       async (client) => {
@@ -248,6 +260,7 @@ export class CollectionStore {
             context: context,
             triggeredBy: triggeredBy,
             transaction: client,
+            dryRun,
           },
         );
 
@@ -259,7 +272,6 @@ export class CollectionStore {
           );
         }
 
-
         data = (await Lobb.instance.eventSystem.emit(
           `core.store.createOne`,
           {
@@ -291,6 +303,7 @@ export class CollectionStore {
     triggeredBy = "INTERNAL",
     context,
     client,
+    dryRun = false,
   }: {
     collectionName: string;
     id: string;
@@ -299,6 +312,7 @@ export class CollectionStore {
     triggeredBy?: TriggeredBy;
     context?: HonoContext;
     client?: PoolClient;
+    dryRun?: boolean;
   }): Promise<ExposedServiceOutput> {
     return await beginTransaction(
       async (client) => {
@@ -311,8 +325,10 @@ export class CollectionStore {
             context: context,
             triggeredBy: triggeredBy,
             transaction: client,
+            dryRun,
           },
         );
+
         data = await this.dbDriver.updateOne(
           collectionName,
           result.id,
@@ -351,6 +367,7 @@ export class CollectionStore {
       triggeredBy = "INTERNAL",
       context,
       client,
+      dryRun = false,
     }: {
       collectionName: string;
       id: string;
@@ -358,6 +375,7 @@ export class CollectionStore {
       triggeredBy?: TriggeredBy;
       context?: HonoContext;
       client?: PoolClient;
+      dryRun?: boolean;
     },
   ): Promise<ExposedServiceOutput> {
     return await beginTransaction(
@@ -370,6 +388,7 @@ export class CollectionStore {
             context: context,
             triggeredBy: triggeredBy,
             transaction: client,
+            dryRun,
           },
         );
 
@@ -1222,6 +1241,62 @@ export class CollectionStore {
     }
   }
 
+  private async resolveChildrenOf(
+    collectionName: string,
+    childrenOf: string,
+    parentId: any,
+  ): Promise<Record<string, any> | null> {
+    const children = Lobb.instance.configManager.getCollectionChildren(childrenOf);
+    const child = children.find((c) => c.collection === collectionName);
+
+    if (!child) {
+      throw new LobbError({
+        code: "BAD_REQUEST",
+        message: `"${collectionName}" is not a child of "${childrenOf}"`,
+      });
+    }
+
+    if (child.type === "fk") {
+      return { [child.field!]: parentId };
+    }
+
+    if (child.type === "m2m") {
+      const junction = await this.findAll({
+        collectionName: child.junction!,
+        params: { filter: { [child.junction_field!]: parentId } },
+      });
+      const ids = junction.data.map((r: any) => r[child.target_field!]);
+      if (ids.length === 0) return null;
+      return { id: { $in: ids } };
+    }
+
+    if (child.type === "polymorphic") {
+      const relations = Lobb.instance.configManager.config.relations ?? [];
+      const polyRelation = relations.find(
+        (r: any) =>
+          r.type === "polymorphic" &&
+          r.from.collection === collectionName &&
+          Array.isArray(r.to) &&
+          r.to.includes(childrenOf),
+      ) as any;
+      if (!polyRelation) {
+        throw new LobbError({
+          code: "BAD_REQUEST",
+          message: `No polymorphic relation found between "${collectionName}" and "${childrenOf}"`,
+        });
+      }
+      return {
+        [polyRelation.from.collection_field]: childrenOf,
+        [polyRelation.from.id_field]: parentId,
+      };
+    }
+
+    throw new LobbError({
+      code: "BAD_REQUEST",
+      message: `Unknown relation type: ${child.type}`,
+    });
+  }
+
   private async handleSingletonCollection(
     collectionName: string,
     context?: HonoContext,

package/src/config/ConfigManager.ts

@@ -62,7 +62,7 @@ export class ConfigManager {
         } as any;
 
         // Convert the original field to virtual (drives the UI picker)
-        collection.fields[fieldName] = { virtual: true, ui: { icon: "Shuffle" } } as any;
+        collection.fields[fieldName] = { virtual: true, ui: { icon: "GitFork" } } as any;
 
         // Auto-register the polymorphic relation
         if (!this.config.relations) this.config.relations = [];
@@ -425,10 +425,10 @@ export class ConfigManager {
     return [];
   }
 
-  public getCollectionChildren(collectionName: string): { type: string; collection: string; field?: string }[] {
+  public getCollectionChildren(collectionName: string): { type: string; collection: string; field?: string; junction?: string; junction_field?: string; target_field?: string }[] {
     const allRelations = this.config.relations ?? [];
     const allCollections = this.config.collections;
-    const children: { type: string; collection: string; field?: string }[] = [];
+    const children: { type: string; collection: string; field?: string; junction?: string; junction_field?: string; target_field?: string }[] = [];
     const seenJunctions = new Set<string>();
 
     for (const relation of allRelations) {
@@ -446,7 +446,13 @@ export class ConfigManager {
           (r as RegularRelation).from.field !== reg.from.field,
         ) as RegularRelation | undefined;
         if (otherSide) {
-          children.push({ type: "m2m", collection: otherSide.to.collection });
+          children.push({
+            type: "m2m",
+            collection: otherSide.to.collection,
+            junction: childCollection,
+            junction_field: reg.from.field,
+            target_field: otherSide.from.field,
+          });
         }
       } else {
         children.push({ type: "fk", collection: childCollection, field: reg.from.field });

package/src/extension/ExtensionSystem.ts

@@ -95,6 +95,7 @@ export class ExtensionSystem {
         ? await extension.meta(Lobb.instance)
         : {};
       extensionMeta.version = extension.version;
+      extensionMeta.icon = extension.icon;
       return extensionMeta;
     }
   }

package/src/types/Extension.ts

@@ -5,6 +5,7 @@ import type { OpenAPIV3_1 } from "openapi-types";
 import type { RelationsConfig } from "./config/relations.ts";
 import type { Lobb } from "../Lobb.ts";
 import type { Workflow } from "../workflows/WorkflowSystem.ts";
+import * as Icons from "lucide-svelte";
 
 interface OpenApiProperty {
   paths: OpenAPIV3_1.Document["paths"];
@@ -17,6 +18,7 @@ export interface Dashboard {
 
 interface ExtensionBase {
   name: string;
+  icon?: keyof typeof Icons;
   workflows?: Workflow[];
   migrations?: Migrations;
   init?: (lobb: Lobb) => Promise<void>;

package/src/workflows/coreWorkflows/index.ts

@@ -9,6 +9,7 @@ import { enumWorkflows } from "./processors/enumWorkflows.ts";
 import { coerceAndValidateWorkflows } from "./processors/coerceAndValidateWorkflows.ts";
 import { coreWorkflowsCollectionWorkflows } from "./workflowsCollection/workflowsCollectionWorkflows.ts";
 import { getQueryCoreWorkflows } from "./queryCoreWorkflows.ts";
+import { dryRunWorkflows } from "./processors/dryRunWorkflows.ts";
 
 export function getCoreWorkflows(): Array<Workflow> {
   return [
@@ -23,5 +24,6 @@ export function getCoreWorkflows(): Array<Workflow> {
     ...getCollectionsTableWorkflows(),
     ...getQueryCoreWorkflows(),
     ...getUtilsCoreWorkflows(),
+    ...dryRunWorkflows,
   ];
 }

package/src/workflows/coreWorkflows/processors/dryRunWorkflows.ts

@@ -0,0 +1,28 @@
+import type { Workflow } from "../../WorkflowSystem.ts";
+
+export const dryRunWorkflows: Workflow[] = [
+  {
+    name: "core_dryRunCreate",
+    eventName: "core.store.preCreateOne",
+    handler: async (input) => {
+      if (!input.dryRun) return input;
+      throw new Response(null, { status: 204 });
+    },
+  },
+  {
+    name: "core_dryRunUpdate",
+    eventName: "core.store.preUpdateOne",
+    handler: async (input) => {
+      if (!input.dryRun) return input;
+      throw new Response(null, { status: 204 });
+    },
+  },
+  {
+    name: "core_dryRunDelete",
+    eventName: "core.store.preDeleteOne",
+    handler: async (input) => {
+      if (!input.dryRun) return input;
+      throw new Response(null, { status: 204 });
+    },
+  },
+];