@nestjs-dash/schematics 0.0.1

package/dist/lib/module/schema.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "SchematicsNestjs-DashModule",
+  "title": "Nestjs-Dash Module Options Schema",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "The name of the module's folder, e.g. widgets.",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What name would you like to use for the module?"
+    },
+    "path": {
+      "type": "string",
+      "format": "path",
+      "description": "Parent directory the module's folder is created under."
+    },
+    "resourceClassName": {
+      "type": "string",
+      "description": "Resource class to register via AdminModule.forFeature([...]). Normally supplied by the resource schematic, not a human."
+    },
+    "resourceImportPath": {
+      "type": "string",
+      "description": "Import specifier for resourceClassName."
+    },
+    "entityClassName": {
+      "type": "string",
+      "description": "Entity class to register via TypeOrmModule.forFeature([...]). Normally supplied by the resource schematic, not a human."
+    },
+    "entityImportPath": {
+      "type": "string",
+      "description": "Import specifier for entityClassName."
+    },
+    "pageClassName": {
+      "type": "string",
+      "description": "Page class to register as a provider. Normally supplied by the resource/page schematics, not a human."
+    },
+    "pageImportPath": {
+      "type": "string",
+      "description": "Import specifier for pageClassName."
+    },
+    "skipRootImport": {
+      "type": "boolean",
+      "default": false,
+      "description": "Skip wiring a newly-created module into the root app module."
+    },
+    "verbose": {
+      "type": "boolean",
+      "default": false,
+      "description": "Print detailed diagnostics about codemod/root-wiring decisions."
+    }
+  },
+  "required": ["name"]
+}

package/dist/lib/page/files/ts/pages/__name@dasherize__-overview.page.ts

@@ -0,0 +1,15 @@
+import { Page, type PageRenderContext } from '@nestjs-dash/core';
+import { AdminPage } from '@nestjs-dash/nestjs';
+import { Injectable } from '@nestjs/common';
+
+@Injectable()
+@AdminPage()
+export class <%= classify(name) %>Page extends Page {
+  static override slug = '<%= dasherize(name) %>-overview';
+  static override title = '<%= classify(name) %> Overview';
+
+  // TODO: query real data, e.g. by injecting NESTJS_DASH_DATA_SOURCE from '@nestjs-dash/nestjs'
+  override async content(_ctx: PageRenderContext): Promise<string> {
+    return '<div class="p-6">TODO: implement <%= classify(name) %> overview content.</div>';
+  }
+}

package/dist/lib/page/page.factory.d.ts

@@ -0,0 +1,4 @@
+import { type Rule } from '@angular-devkit/schematics';
+import type { PageOptions } from './page.schema.js';
+export declare function main(options: PageOptions): Rule;
+//# sourceMappingURL=page.factory.d.ts.map

package/dist/lib/page/page.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.factory.d.ts","sourceRoot":"","sources":["../../../src/lib/page/page.factory.ts"],"names":[],"mappings":"AACA,OAAO,EAOL,KAAK,IAAI,EAGV,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,wBAAgB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAiB/C"}

package/dist/lib/page/page.factory.js

@@ -0,0 +1,18 @@
+import { strings } from '@angular-devkit/core';
+import { apply, MergeStrategy, mergeWith, move, template, url, } from '@angular-devkit/schematics';
+import { join, normalize } from 'node:path/posix';
+import { toKebabCase } from '../../utils/naming.js';
+export function main(options) {
+    return (tree, context) => {
+        const parentDir = options.dir ? normalize(`/${options.dir}`) : normalize('/');
+        const kebab = toKebabCase(options.name);
+        const targetPath = join(parentDir, 'pages', `${kebab}-overview.page.ts`);
+        if (tree.exists(targetPath) && !options.force) {
+            context.logger.warn(`Skipped (already exists): ${targetPath}`);
+            return tree;
+        }
+        const strategy = tree.exists(targetPath) ? MergeStrategy.Overwrite : MergeStrategy.Default;
+        return mergeWith(apply(url('./files/ts'), [template({ ...strings, ...options }), move(parentDir)]), strategy)(tree, context);
+    };
+}
+//# sourceMappingURL=page.factory.js.map

package/dist/lib/page/page.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.factory.js","sourceRoot":"","sources":["../../../src/lib/page/page.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EACL,KAAK,EACL,aAAa,EACb,SAAS,EACT,IAAI,EACJ,QAAQ,EACR,GAAG,GAIJ,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,MAAM,UAAU,IAAI,CAAC,OAAoB;IACvC,OAAO,CAAC,IAAU,EAAE,OAAyB,EAAE,EAAE;QAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAC9E,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,KAAK,mBAAmB,CAAC,CAAC;QAEzE,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC9C,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,6BAA6B,UAAU,EAAE,CAAC,CAAC;YAC/D,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC;QAC3F,OAAO,SAAS,CACd,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EACjF,QAAQ,CACT,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnB,CAAC,CAAC;AACJ,CAAC"}

package/dist/lib/page/schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "SchematicsNestjs-DashPage",
+  "title": "Nestjs-Dash Page Options Schema",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "The name of the page, e.g. Widget or widget.",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What name would you like to use for this page?"
+    },
+    "dir": {
+      "type": "string",
+      "format": "path",
+      "description": "Target directory (a pages/ subfolder is added)."
+    },
+    "force": {
+      "type": "boolean",
+      "default": false,
+      "description": "Overwrite an existing <name>-overview.page.ts without prompting."
+    }
+  },
+  "required": ["name"]
+}

package/dist/lib/panel/files/ts/__name@dasherize__.panel.ts

@@ -0,0 +1,17 @@
+import { Panel } from '@nestjs-dash/core';
+import { AdminModule } from '@nestjs-dash/nestjs';
+
+export function create<%= classify(name) %>Panel() {
+  return Panel.make()
+    .id('<%= dasherize(name) %>')
+    .path('/<%= dasherize(name) %>')
+    .brandName('<%= classify(name) %>')
+    .resources([]);
+}
+
+export const <%= classify(name) %>AdminModule = AdminModule.forRoot({
+  panel: create<%= classify(name) %>Panel(),<% if (audit) { %>
+  // audit.enabled requires a TypeORM DataSource — pass `dataSource` here,
+  // or switch to AdminModule.forRootAsync({ inject: [DataSource], useFactory: (dataSource) => ({ ... }) }).
+  audit: { enabled: true },<% } %>
+});

package/dist/lib/panel/panel.factory.d.ts

@@ -0,0 +1,4 @@
+import { type Rule } from '@angular-devkit/schematics';
+import type { PanelOptions } from './panel.schema.js';
+export declare function main(options: PanelOptions): Rule;
+//# sourceMappingURL=panel.factory.d.ts.map

package/dist/lib/panel/panel.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel.factory.d.ts","sourceRoot":"","sources":["../../../src/lib/panel/panel.factory.ts"],"names":[],"mappings":"AACA,OAAO,EAOL,KAAK,IAAI,EAGV,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAItD,wBAAgB,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAsBhD"}

package/dist/lib/panel/panel.factory.js

@@ -0,0 +1,20 @@
+import { strings } from '@angular-devkit/core';
+import { apply, MergeStrategy, mergeWith, move, template, url, } from '@angular-devkit/schematics';
+import { join } from 'node:path/posix';
+import { toKebabCase } from '../../utils/naming.js';
+const PANEL_DIR = '/src/admin';
+export function main(options) {
+    return (tree, context) => {
+        const targetPath = join(PANEL_DIR, `${toKebabCase(options.name)}.panel.ts`);
+        if (tree.exists(targetPath) && !options.force) {
+            context.logger.warn(`Skipped (already exists): ${targetPath}`);
+            return tree;
+        }
+        const strategy = tree.exists(targetPath) ? MergeStrategy.Overwrite : MergeStrategy.Default;
+        return mergeWith(apply(url('./files/ts'), [
+            template({ audit: false, ...strings, ...options }),
+            move(PANEL_DIR),
+        ]), strategy)(tree, context);
+    };
+}
+//# sourceMappingURL=panel.factory.js.map

package/dist/lib/panel/panel.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel.factory.js","sourceRoot":"","sources":["../../../src/lib/panel/panel.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EACL,KAAK,EACL,aAAa,EACb,SAAS,EACT,IAAI,EACJ,QAAQ,EACR,GAAG,GAIJ,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,MAAM,SAAS,GAAG,YAAY,CAAC;AAE/B,MAAM,UAAU,IAAI,CAAC,OAAqB;IACxC,OAAO,CAAC,IAAU,EAAE,OAAyB,EAAE,EAAE;QAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAE5E,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC9C,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,6BAA6B,UAAU,EAAE,CAAC,CAAC;YAC/D,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC;QAC3F,OAAO,SAAS,CACd,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE;YAKvB,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;YAClD,IAAI,CAAC,SAAS,CAAC;SAChB,CAAC,EACF,QAAQ,CACT,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnB,CAAC,CAAC;AACJ,CAAC"}

package/dist/lib/panel/schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "SchematicsNestjs-DashPanel",
+  "title": "Nestjs-Dash Panel Options Schema",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "The name of the panel, e.g. Admin.",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What name would you like to use for this panel?"
+    },
+    "force": {
+      "type": "boolean",
+      "default": false,
+      "description": "Overwrite an existing <name>.panel.ts without prompting."
+    },
+    "audit": {
+      "type": "boolean",
+      "default": false,
+      "description": "Enable the built-in audit log (audit.enabled) and read-only Activity resource. Requires a TypeORM dataSource — see the generated TODO comment."
+    }
+  },
+  "required": ["name"]
+}

package/dist/lib/relation-manager/files/ts/relation-managers/__name@dasherize__.relation-manager.ts

@@ -0,0 +1,13 @@
+import { RelationManager, TextColumn, type Table } from '@nestjs-dash/core';
+
+export class <%= classify(name) %>RelationManager extends RelationManager {
+  static override relationship = '<%= dasherize(name) %>';
+  static override type = '<%= type %>' as const;
+  static override relatedResource = '<%= relatedResource %>';
+<% if (foreignKey) { %>  static override foreignKey = '<%= foreignKey %>';
+<% } %>  static override title = '<%= title %>';
+
+  static override table(table: Table) {
+    return table.columns([TextColumn.make('id').label('ID')]);
+  }
+}

package/dist/lib/relation-manager/relation-manager.factory.d.ts

@@ -0,0 +1,4 @@
+import { type Rule } from '@angular-devkit/schematics';
+import type { RelationManagerOptions } from './relation-manager.schema.js';
+export declare function main(options: RelationManagerOptions): Rule;
+//# sourceMappingURL=relation-manager.factory.d.ts.map

package/dist/lib/relation-manager/relation-manager.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation-manager.factory.d.ts","sourceRoot":"","sources":["../../../src/lib/relation-manager/relation-manager.factory.ts"],"names":[],"mappings":"AACA,OAAO,EAQL,KAAK,IAAI,EAGV,MAAM,4BAA4B,CAAC;AAKpC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAE3E,wBAAgB,IAAI,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAgE1D"}

package/dist/lib/relation-manager/relation-manager.factory.js

@@ -0,0 +1,59 @@
+import { strings } from '@angular-devkit/core';
+import { apply, chain, MergeStrategy, mergeWith, move, template, url, } from '@angular-devkit/schematics';
+import { join, normalize } from 'node:path/posix';
+import { codemodStaticArrayProperty } from '../../utils/class-codemod.js';
+import { normalizePath, relativeImportPath } from '../../utils/detect.js';
+import { humanize, toKebabCase, toPascalCase } from '../../utils/naming.js';
+export function main(options) {
+    return (tree, context) => {
+        const parentDir = normalize(`/${options.dir}`);
+        const kebab = toKebabCase(options.name);
+        const relatedResource = options.relatedResource ? toKebabCase(options.relatedResource) : kebab;
+        const type = options.type ?? 'has-many';
+        const title = options.title ?? humanize(toPascalCase(options.name));
+        const className = `${toPascalCase(options.name)}RelationManager`;
+        const targetPath = join(parentDir, 'relation-managers', `${kebab}.relation-manager.ts`);
+        if (tree.exists(targetPath) && !options.force) {
+            context.logger.warn(`Skipped (already exists): ${targetPath}`);
+            return tree;
+        }
+        const strategy = tree.exists(targetPath) ? MergeStrategy.Overwrite : MergeStrategy.Default;
+        const rules = [
+            mergeWith(apply(url('./files/ts'), [
+                template({
+                    foreignKey: null,
+                    ...strings,
+                    ...options,
+                    name: options.name,
+                    relatedResource,
+                    type,
+                    title,
+                }),
+                move(parentDir),
+            ]), strategy),
+        ];
+        if (options.resource) {
+            rules.push((wiringTree, wiringContext) => {
+                const resourcePath = normalizePath(options.resource);
+                if (!wiringTree.exists(resourcePath)) {
+                    throw new Error(`--resource points at ${resourcePath}, which doesn't exist`);
+                }
+                const result = codemodStaticArrayProperty({
+                    tree: wiringTree,
+                    filePath: resourcePath,
+                    propertyName: 'relationManagers',
+                    elementText: className,
+                    namedImports: [
+                        { moduleSpecifier: relativeImportPath(resourcePath, targetPath), name: className },
+                    ],
+                });
+                if (options.verbose) {
+                    wiringContext.logger.info(`${result.changed ? 'Modified' : 'No changes needed'}: ${resourcePath}`);
+                }
+                return wiringTree;
+            });
+        }
+        return chain(rules)(tree, context);
+    };
+}
+//# sourceMappingURL=relation-manager.factory.js.map

package/dist/lib/relation-manager/relation-manager.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation-manager.factory.js","sourceRoot":"","sources":["../../../src/lib/relation-manager/relation-manager.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EACL,KAAK,EACL,KAAK,EACL,aAAa,EACb,SAAS,EACT,IAAI,EACJ,QAAQ,EACR,GAAG,GAIJ,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG5E,MAAM,UAAU,IAAI,CAAC,OAA+B;IAClD,OAAO,CAAC,IAAU,EAAE,OAAyB,EAAE,EAAE;QAC/C,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC/F,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,UAAU,CAAC;QACxC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACpE,MAAM,SAAS,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC;QACjE,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,mBAAmB,EAAE,GAAG,KAAK,sBAAsB,CAAC,CAAC;QAExF,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC9C,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,6BAA6B,UAAU,EAAE,CAAC,CAAC;YAC/D,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC;QAC3F,MAAM,KAAK,GAAW;YACpB,SAAS,CACP,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE;gBAKvB,QAAQ,CAAC;oBACP,UAAU,EAAE,IAAI;oBAChB,GAAG,OAAO;oBACV,GAAG,OAAO;oBACV,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,eAAe;oBACf,IAAI;oBACJ,KAAK;iBACN,CAAC;gBACF,IAAI,CAAC,SAAS,CAAC;aAChB,CAAC,EACF,QAAQ,CACT;SACF,CAAC;QAEF,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,CAAC,UAAgB,EAAE,aAA+B,EAAE,EAAE;gBAC/D,MAAM,YAAY,GAAG,aAAa,CAAC,OAAO,CAAC,QAAS,CAAC,CAAC;gBACtD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;oBACrC,MAAM,IAAI,KAAK,CAAC,wBAAwB,YAAY,uBAAuB,CAAC,CAAC;gBAC/E,CAAC;gBACD,MAAM,MAAM,GAAG,0BAA0B,CAAC;oBACxC,IAAI,EAAE,UAAU;oBAChB,QAAQ,EAAE,YAAY;oBACtB,YAAY,EAAE,kBAAkB;oBAChC,WAAW,EAAE,SAAS;oBACtB,YAAY,EAAE;wBACZ,EAAE,eAAe,EAAE,kBAAkB,CAAC,YAAY,EAAE,UAAU,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE;qBACnF;iBACF,CAAC,CAAC;gBACH,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;oBACpB,aAAa,CAAC,MAAM,CAAC,IAAI,CACvB,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,mBAAmB,KAAK,YAAY,EAAE,CACxE,CAAC;gBACJ,CAAC;gBACD,OAAO,UAAU,CAAC;YACpB,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC,CAAC;AACJ,CAAC"}

package/dist/lib/relation-manager/schema.json

@@ -0,0 +1,56 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "SchematicsNestjs-DashRelationManager",
+  "title": "Nestjs-Dash RelationManager Options Schema",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "The relationship name, e.g. books.",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What is the name of this relationship?"
+    },
+    "dir": {
+      "type": "string",
+      "format": "path",
+      "description": "Target directory (a relation-managers/ subfolder is added)."
+    },
+    "relatedResource": {
+      "type": "string",
+      "description": "Slug of the related resource. Defaults to the dasherized name."
+    },
+    "type": {
+      "type": "string",
+      "enum": ["has-many", "belongs-to-many"],
+      "default": "has-many",
+      "description": "Relation type."
+    },
+    "foreignKey": {
+      "type": "string",
+      "description": "Foreign key column on the related entity (has-many only)."
+    },
+    "title": {
+      "type": "string",
+      "description": "Tab/section title. Defaults to the humanized name."
+    },
+    "resource": {
+      "type": "string",
+      "format": "path",
+      "description": "Path to an existing Resource file — when given, wires the generated class into its static override relationManagers = [...] array."
+    },
+    "force": {
+      "type": "boolean",
+      "default": false,
+      "description": "Overwrite an existing <name>.relation-manager.ts without prompting."
+    },
+    "verbose": {
+      "type": "boolean",
+      "default": false,
+      "description": "Print diagnostics about the resource wiring codemod."
+    }
+  },
+  "required": ["name", "dir"]
+}

package/dist/lib/resource/resource.factory.d.ts

@@ -0,0 +1,4 @@
+import { type Rule } from '@angular-devkit/schematics';
+import type { ResourceOptions } from './resource.schema.js';
+export declare function main(options: ResourceOptions): Rule;
+//# sourceMappingURL=resource.factory.d.ts.map

package/dist/lib/resource/resource.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.factory.d.ts","sourceRoot":"","sources":["../../../src/lib/resource/resource.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,IAAI,EAGV,MAAM,4BAA4B,CAAC;AAapC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAqC5D,wBAAgB,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CA0GnD"}

package/dist/lib/resource/resource.factory.js

@@ -0,0 +1,112 @@
+import { chain, schematic, SchematicsException, } from '@angular-devkit/schematics';
+import { dirname, join } from 'node:path/posix';
+import { findEntityFile, hasNestCoreDependency, normalizePath, relativeImportPath, resolveSourceRoot, resolveTargetDir, } from '../../utils/detect.js';
+import { introspectEntitySource } from '../../utils/entity-introspect.js';
+import { toKebabCase, toPascalCase } from '../../utils/naming.js';
+import { renderResourceTemplate } from './resource.render.js';
+function writeResourceFile(options) {
+    return (tree, context) => {
+        if (tree.exists(options.resourceFilePath) && !options.force) {
+            context.logger.warn(`Skipped (already exists): ${options.resourceFilePath}`);
+            return tree;
+        }
+        const source = renderResourceTemplate(options.name, {
+            entityImportPath: options.entityImportPath,
+            entityClassName: options.entityClassName,
+            fields: options.fields,
+            softDelete: options.softDelete,
+            withPermissions: options.withPermissions,
+        });
+        if (tree.exists(options.resourceFilePath)) {
+            tree.overwrite(options.resourceFilePath, source);
+        }
+        else {
+            tree.create(options.resourceFilePath, source);
+        }
+        return tree;
+    };
+}
+export function main(options) {
+    return (tree, context) => {
+        if (!hasNestCoreDependency(tree)) {
+            throw new SchematicsException('Could not find a NestJS project (no package.json with a "@nestjs/core" dependency at the tree root). Run this from inside a NestJS project.');
+        }
+        const sourceRoot = resolveSourceRoot(tree);
+        const { dir, folderName, matched, matchedModulePath } = resolveTargetDir(tree, {
+            sourceRoot,
+            name: options.name,
+            explicitDir: options.dir,
+        });
+        if (options.verbose && matched) {
+            context.logger.info(`Matched existing module folder ${dir} via *.module.ts fuzzy-match (found ${matchedModulePath}).`);
+        }
+        const pascal = toPascalCase(options.name);
+        const kebab = toKebabCase(options.name);
+        let entityClassName = `${pascal}Entity`;
+        const resourceClassName = `${pascal}Resource`;
+        const pageClassName = options.page ? `${pascal}Page` : undefined;
+        const entityFilePath = options.entityFilePath
+            ? normalizePath(options.entityFilePath)
+            : findEntityFile(tree, dir, options.name);
+        let entityFields;
+        const notes = [];
+        const rules = [];
+        if (!entityFilePath) {
+            if (options.entity === false) {
+                throw new SchematicsException(`--no-entity was passed but no existing entity file was found under ${dir}. Create the entity first, or drop --no-entity.`);
+            }
+            rules.push(schematic('entity', {
+                name: options.name,
+                path: dir,
+                flat: false,
+                force: options.force ?? false,
+                softDelete: options.softDelete ?? false,
+            }));
+        }
+        else {
+            const content = tree.read(entityFilePath).toString('utf-8');
+            try {
+                const introspected = introspectEntitySource(entityFilePath, content);
+                entityClassName = introspected.className;
+                entityFields = introspected.fields;
+                notes.push(`Reusing existing entity at ${entityFilePath}`);
+            }
+            catch (error) {
+                notes.push(`Could not read field declarations from ${entityFilePath} (${error instanceof Error ? error.message : String(error)}) — using default table/form fields.`);
+            }
+        }
+        const resolvedEntityFilePath = entityFilePath ?? join(dir, 'entities', `${kebab}.entity.ts`);
+        const resourceFilePath = join(dir, 'resources', `${kebab}.resource.ts`);
+        rules.push(writeResourceFile({
+            resourceFilePath,
+            entityImportPath: relativeImportPath(resourceFilePath, resolvedEntityFilePath),
+            entityClassName,
+            fields: entityFields,
+            name: options.name,
+            force: options.force ?? false,
+            softDelete: Boolean(options.softDelete) && !entityFilePath,
+            withPermissions: options.withPermissions,
+        }));
+        let pageFilePath;
+        if (options.page) {
+            pageFilePath = join(dir, 'pages', `${kebab}-overview.page.ts`);
+            rules.push(schematic('page', { name: options.name, dir, force: options.force ?? false }));
+        }
+        const modulePath = join(dir, `${folderName}.module.ts`);
+        rules.push(schematic('module', {
+            name: folderName,
+            path: dirname(dir),
+            resourceClassName,
+            resourceImportPath: relativeImportPath(modulePath, resourceFilePath),
+            entityClassName,
+            entityImportPath: relativeImportPath(modulePath, resolvedEntityFilePath),
+            pageClassName,
+            pageImportPath: pageFilePath ? relativeImportPath(modulePath, pageFilePath) : undefined,
+            verbose: options.verbose ?? false,
+        }));
+        for (const note of notes)
+            context.logger.info(note);
+        return chain(rules)(tree, context);
+    };
+}
+//# sourceMappingURL=resource.factory.js.map

package/dist/lib/resource/resource.factory.js.map

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

package/dist/lib/resource/resource.render.d.ts

@@ -0,0 +1,10 @@
+import type { EntityField } from '../../utils/entity-introspect.js';
+export interface RenderResourceOptions {
+    entityImportPath: string;
+    entityClassName?: string;
+    fields?: EntityField[];
+    softDelete?: boolean;
+    withPermissions?: boolean;
+}
+export declare function renderResourceTemplate(name: string, options: RenderResourceOptions): string;
+//# sourceMappingURL=resource.render.d.ts.map

package/dist/lib/resource/resource.render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.render.d.ts","sourceRoot":"","sources":["../../../src/lib/resource/resource.render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAIpE,MAAM,WAAW,qBAAqB;IAEpC,gBAAgB,EAAE,MAAM,CAAC;IAEzB,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IAEvB,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AA4BD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAgH3F"}

package/dist/lib/resource/resource.render.js

@@ -0,0 +1,125 @@
+import { buildResourceDeclarations } from '../../utils/field-mapping.js';
+import { humanize, toKebabCase, toPascalCase } from '../../utils/naming.js';
+function splitNotes(notes) {
+    const fieldNotes = new Map();
+    const classNotes = [];
+    for (const note of notes) {
+        const match = /^Field '([^']+)' is an enum/.exec(note);
+        if (match)
+            fieldNotes.set(match[1], note);
+        else
+            classNotes.push(note);
+    }
+    return { fieldNotes, classNotes };
+}
+function annotateFormLines(formLines, fieldNotes) {
+    return formLines.flatMap((line) => {
+        const match = /\.make\('([^']+)'\)/.exec(line);
+        const note = match ? fieldNotes.get(match[1]) : undefined;
+        return note ? [`// TODO: ${note}`, line] : [line];
+    });
+}
+export function renderResourceTemplate(name, options) {
+    const pascal = toPascalCase(name);
+    const slug = `${toKebabCase(name)}s`;
+    const label = `${humanize(pascal)}s`;
+    const entityClassName = options.entityClassName ?? `${pascal}Entity`;
+    const decl = options.fields ? buildResourceDeclarations(options.fields) : undefined;
+    const { fieldNotes, classNotes } = decl
+        ? splitNotes(decl.notes)
+        : { fieldNotes: new Map(), classNotes: [] };
+    const columnImports = decl ? decl.columnImports : ['TextColumn'];
+    const formImports = decl ? decl.formImports : ['TextInput'];
+    const namedImports = [
+        ...new Set([
+            'BulkDeleteAction',
+            'CreateAction',
+            'DeleteAction',
+            'EditAction',
+            'Resource',
+            'ViewAction',
+            ...(options.softDelete ? ['RestoreAction'] : []),
+            ...columnImports,
+            ...formImports,
+        ]),
+    ].sort();
+    const rowActions = [
+        'ViewAction.make()',
+        'EditAction.make()',
+        'DeleteAction.make()',
+        ...(options.softDelete ? ['RestoreAction.make()'] : []),
+    ].join(', ');
+    const columnsBlock = decl
+        ? decl.columnLines.map((line) => `        ${line}`).join('\n')
+        : [
+            `        TextColumn.make('id').label('ID').sortable(),`,
+            `        TextColumn.make('name').label('Name').searchable().sortable(),`,
+            `        TextColumn.make('createdAt').label('Created').sortable(),`,
+        ].join('\n');
+    const formBlock = decl
+        ? `\n${annotateFormLines(decl.formLines, fieldNotes)
+            .map((line) => `      ${line}`)
+            .join('\n')}\n    `
+        : `TextInput.make('name').required().label('Name')`;
+    const sortBlock = decl
+        ? decl.defaultSortField
+            ? `\n      .defaultSortBy([['${decl.defaultSortField.name}', '${decl.defaultSortField.direction}']])`
+            : ''
+        : `\n      .defaultSortBy([['createdAt', 'DESC']])`;
+    const relationManagerComment = classNotes.length > 0
+        ? classNotes.map((note) => `  // TODO: ${note}`).join('\n')
+        : '  // Add RelationManager subclasses here, e.g. static override relationManagers = [...]';
+    const permissionsBlock = options.withPermissions
+        ? `
+  // TODO: replace with real role/permission checks — \`ctx.user\` is whatever
+  // your auth resolver returned. Each case defaults to \`true\` (unrestricted);
+  // tighten as needed. See AdminPolicyContext for the full ctx shape.
+  static override can(action: string, ctx: AdminPolicyContext) {
+    switch (action) {
+      case 'view':
+        return true;
+      case 'create':
+        return true;
+      case 'update':
+        return true;
+      case 'delete':
+        return true;
+      default:
+        return true;
+    }
+  }
+
+`
+        : '';
+    return `import {
+  ${namedImports.join(',\n  ')},${options.withPermissions ? '\n  type AdminPolicyContext,' : ''}
+  type Schema,
+  type Table,
+} from '@nestjs-dash/core';
+import { ${entityClassName} } from '${options.entityImportPath}';
+
+export class ${pascal}Resource extends Resource {
+  static override slug = '${slug}';
+  static override label = '${label}';
+  static override model = ${entityClassName};
+${permissionsBlock}
+${relationManagerComment}
+
+  static override table(table: Table) {
+    return table
+      .columns([
+${columnsBlock}
+      ])
+      .actions([${rowActions}])
+      .toolbarActions([CreateAction.make().icon('plus')])
+      .bulkActions([BulkDeleteAction.make()])${sortBlock}
+      .defaultLimit(20);
+  }
+
+  static override form(form: Schema) {
+    return form.components([${formBlock}]);
+  }
+}
+`;
+}
+//# sourceMappingURL=resource.render.js.map