@nubitio/eject 0.6.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Johan Guerreros
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/bin/nubit.mjs

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+/**
+ * Nubit eject CLI — generates explicit resource/page files from Hydra docs.
+ * Run from the monorepo root: node packages/eject/bin/nubit.mjs eject fields /api/products
+ */
+import process from 'node:process';
+import { writeFileSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+async function loadModule() {
+  const distRoot = resolve(__dirname, '../dist');
+  try {
+    return await import(pathToFileURL(resolve(distRoot, 'index.mjs')).href);
+  } catch {
+    // Dev fallback: import TypeScript sources via relative path (requires built hydra/crud)
+    return await import(pathToFileURL(resolve(__dirname, '../src/runCli.ts')).href);
+  }
+}
+
+const [, , command, target, ...rest] = process.argv;
+
+function flag(name, fallback) {
+  const index = rest.indexOf(name);
+  if (index === -1) return fallback;
+  return rest[index + 1] ?? fallback;
+}
+
+const mod = await loadModule();
+await mod.runCli({ command, target, rest, flag, writeFileSync, resolve });

package/dist/index.cjs

@@ -0,0 +1,134 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _nubitio_hydra = require("@nubitio/hydra");
+//#region packages/eject/src/ejectFromDocs.ts
+function normalizeUrl(url) {
+	const base = url.split("?")[0];
+	return base.startsWith("/") ? base.slice(1) : base;
+}
+async function ejectFieldsFromDocs(apiUrl, docsUrl) {
+	const response = await fetch(docsUrl);
+	if (!response.ok) throw new Error(`Failed to fetch ${docsUrl}: ${response.status} ${response.statusText}`);
+	const doc = await response.json();
+	const resourceMap = doc["@type"] === "ApiDocumentation" || doc["@type"] === "hydra:ApiDocumentation" ? (0, _nubitio_hydra.parseHydraDoc)(doc, {}) : (0, _nubitio_hydra.parseOpenApiDoc)(doc);
+	const normalizedInput = normalizeUrl(apiUrl);
+	const resourceSchema = Object.values(resourceMap).find((schema) => normalizeUrl(schema.apiUrl) === normalizedInput);
+	if (!resourceSchema) {
+		const known = Object.values(resourceMap).map((schema) => schema.apiUrl).join(", ");
+		throw new Error(`No schema found for ${apiUrl}. Known: ${known || "(none)"}`);
+	}
+	const fields = (0, _nubitio_hydra.mapHydraSchemaToFields)(resourceSchema, (className) => resourceMap[className]?.apiUrl, (className) => resourceMap[className]);
+	return {
+		apiUrl: resourceSchema.apiUrl,
+		className: resourceSchema.className,
+		fields
+	};
+}
+//#endregion
+//#region packages/eject/src/fieldToCode.ts
+const BUILDER_BY_TYPE = {
+	text: "textField",
+	password: "passwordField",
+	textarea: "textareaField",
+	date: "dateField",
+	datetime: "datetimeField",
+	number: "numberField",
+	currency: "currencyField",
+	select: "selectField",
+	enum: "enumField",
+	entity: "entityField",
+	radio: "radioField",
+	switch: "switchField",
+	checkbox: "checkboxField",
+	file: "fileField",
+	image: "imageField",
+	tags: "tagsField",
+	html: "htmlField",
+	none: "noneField"
+};
+function fieldToCodeLine(field) {
+	const builder = BUILDER_BY_TYPE[field.type] ?? "textField";
+	const parts = [];
+	if (builder === "entityField" && field.url) parts.push(`${builder}('${field.url}', '${field.valueField || "_iri"}', '${field.textField || "name"}')`);
+	else if (builder === "enumField" && field.data.length > 0) {
+		const options = field.data.map((opt) => `{ value: ${JSON.stringify(opt.value)}, text: ${JSON.stringify(opt.text)} }`).join(", ");
+		parts.push(`${builder}([${options}])`);
+	} else if (builder === "fileField" || builder === "imageField") parts.push(`${builder}('${field.url ?? "/api/media"}')`);
+	else parts.push(`${builder}()`);
+	let chain = parts[0] + `.name('${field.name}').label(${JSON.stringify(field.label)})`;
+	if (field.required) chain += ".required(true)";
+	if (field.readonly) chain += ".readonly(true)";
+	if (field.precision !== void 0 && field.type === "number") chain += `.precision(${field.precision})`;
+	chain += ".build()";
+	return `    ${chain},`;
+}
+function renderFieldsModule(apiUrl, fields) {
+	const hintable = fields.filter((f) => !f.isIdentity);
+	const imports = new Set(["defineResource"]);
+	for (const field of hintable) {
+		const builder = BUILDER_BY_TYPE[field.type] ?? "textField";
+		imports.add(builder);
+	}
+	return `import { ${[...imports].join(", ")} } from '@nubitio/react-admin';
+
+/** Ejected from ${apiUrl} — ${(/* @__PURE__ */ new Date()).toISOString()} */
+export const resource = defineResource('${apiUrl}', {
+  fields: [
+${hintable.map(fieldToCodeLine).join("\n")}
+  ],
+});
+`;
+}
+function renderPageModule(componentName, apiUrl, title) {
+	return `import { SmartCrudPage, defineResource } from '@nubitio/react-admin';
+
+const resource = defineResource('${apiUrl}', {
+  title: ${JSON.stringify(title)},
+});
+
+export function ${componentName}() {
+  return <SmartCrudPage resource={resource} />;
+}
+`;
+}
+//#endregion
+//#region packages/eject/src/runCli.ts
+async function runCli(ctx) {
+	const { command, target, rest, flag, writeFileSync, resolve } = ctx;
+	if (!command || command === "--help" || command === "-h") {
+		console.log(`Usage:
+  nubit eject fields <apiUrl> [--docs http://localhost:8000/api/docs.jsonld] [--out file.ts]
+  nubit eject page <Name> <apiUrl> [--docs ...] [--out Pages/Name.tsx] [--title "Title"]
+`);
+		return;
+	}
+	const docsUrl = flag("--docs", "http://localhost:8000/api/docs.jsonld");
+	const outPath = flag("--out", "");
+	if (command === "eject" && target === "fields") {
+		const apiUrl = rest.find((arg) => !arg.startsWith("--") && arg !== docsUrl && arg !== outPath);
+		if (!apiUrl) throw new Error("Missing apiUrl argument");
+		const result = await ejectFieldsFromDocs(apiUrl, docsUrl);
+		const code = renderFieldsModule(result.apiUrl, result.fields);
+		if (outPath) {
+			writeFileSync(resolve(outPath), code);
+			console.log(`Wrote ${outPath} (${result.className}, ${result.fields.length} fields)`);
+		} else console.log(code);
+		return;
+	}
+	if (command === "eject" && target === "page") {
+		const [componentName, apiUrl] = rest.filter((arg) => !arg.startsWith("--") && arg !== docsUrl && arg !== outPath);
+		if (!componentName || !apiUrl) throw new Error("Usage: nubit eject page <ComponentName> <apiUrl>");
+		const code = renderPageModule(componentName, apiUrl, flag("--title", componentName.replace(/Page$/, "")));
+		if (outPath) {
+			writeFileSync(resolve(outPath), code);
+			console.log(`Wrote ${outPath}`);
+		} else console.log(code);
+		return;
+	}
+	throw new Error(`Unknown command: ${command} ${target ?? ""}`);
+}
+//#endregion
+exports.ejectFieldsFromDocs = ejectFieldsFromDocs;
+exports.fieldToCodeLine = fieldToCodeLine;
+exports.renderFieldsModule = renderFieldsModule;
+exports.renderPageModule = renderPageModule;
+exports.runCli = runCli;

package/dist/index.d.cts

@@ -0,0 +1,26 @@
+import { Field } from "@nubitio/crud";
+
+//#region packages/eject/src/ejectFromDocs.d.ts
+interface EjectFieldsResult {
+  apiUrl: string;
+  className: string;
+  fields: Field[];
+}
+declare function ejectFieldsFromDocs(apiUrl: string, docsUrl: string): Promise<EjectFieldsResult>;
+//#endregion
+//#region packages/eject/src/fieldToCode.d.ts
+declare function fieldToCodeLine(field: Field): string;
+declare function renderFieldsModule(apiUrl: string, fields: Field[]): string;
+declare function renderPageModule(componentName: string, apiUrl: string, title: string): string;
+//#endregion
+//#region packages/eject/src/runCli.d.ts
+declare function runCli(ctx: {
+  command?: string;
+  target?: string;
+  rest: string[];
+  flag: (name: string, fallback: string) => string;
+  writeFileSync: (path: string, data: string) => void;
+  resolve: (...paths: string[]) => string;
+}): Promise<void>;
+//#endregion
+export { ejectFieldsFromDocs, fieldToCodeLine, renderFieldsModule, renderPageModule, runCli };

package/dist/index.d.mts

@@ -0,0 +1,26 @@
+import { Field } from "@nubitio/crud";
+
+//#region packages/eject/src/ejectFromDocs.d.ts
+interface EjectFieldsResult {
+  apiUrl: string;
+  className: string;
+  fields: Field[];
+}
+declare function ejectFieldsFromDocs(apiUrl: string, docsUrl: string): Promise<EjectFieldsResult>;
+//#endregion
+//#region packages/eject/src/fieldToCode.d.ts
+declare function fieldToCodeLine(field: Field): string;
+declare function renderFieldsModule(apiUrl: string, fields: Field[]): string;
+declare function renderPageModule(componentName: string, apiUrl: string, title: string): string;
+//#endregion
+//#region packages/eject/src/runCli.d.ts
+declare function runCli(ctx: {
+  command?: string;
+  target?: string;
+  rest: string[];
+  flag: (name: string, fallback: string) => string;
+  writeFileSync: (path: string, data: string) => void;
+  resolve: (...paths: string[]) => string;
+}): Promise<void>;
+//#endregion
+export { ejectFieldsFromDocs, fieldToCodeLine, renderFieldsModule, renderPageModule, runCli };

package/dist/index.mjs

@@ -0,0 +1,129 @@
+import { mapHydraSchemaToFields, parseHydraDoc, parseOpenApiDoc } from "@nubitio/hydra";
+//#region packages/eject/src/ejectFromDocs.ts
+function normalizeUrl(url) {
+	const base = url.split("?")[0];
+	return base.startsWith("/") ? base.slice(1) : base;
+}
+async function ejectFieldsFromDocs(apiUrl, docsUrl) {
+	const response = await fetch(docsUrl);
+	if (!response.ok) throw new Error(`Failed to fetch ${docsUrl}: ${response.status} ${response.statusText}`);
+	const doc = await response.json();
+	const resourceMap = doc["@type"] === "ApiDocumentation" || doc["@type"] === "hydra:ApiDocumentation" ? parseHydraDoc(doc, {}) : parseOpenApiDoc(doc);
+	const normalizedInput = normalizeUrl(apiUrl);
+	const resourceSchema = Object.values(resourceMap).find((schema) => normalizeUrl(schema.apiUrl) === normalizedInput);
+	if (!resourceSchema) {
+		const known = Object.values(resourceMap).map((schema) => schema.apiUrl).join(", ");
+		throw new Error(`No schema found for ${apiUrl}. Known: ${known || "(none)"}`);
+	}
+	const fields = mapHydraSchemaToFields(resourceSchema, (className) => resourceMap[className]?.apiUrl, (className) => resourceMap[className]);
+	return {
+		apiUrl: resourceSchema.apiUrl,
+		className: resourceSchema.className,
+		fields
+	};
+}
+//#endregion
+//#region packages/eject/src/fieldToCode.ts
+const BUILDER_BY_TYPE = {
+	text: "textField",
+	password: "passwordField",
+	textarea: "textareaField",
+	date: "dateField",
+	datetime: "datetimeField",
+	number: "numberField",
+	currency: "currencyField",
+	select: "selectField",
+	enum: "enumField",
+	entity: "entityField",
+	radio: "radioField",
+	switch: "switchField",
+	checkbox: "checkboxField",
+	file: "fileField",
+	image: "imageField",
+	tags: "tagsField",
+	html: "htmlField",
+	none: "noneField"
+};
+function fieldToCodeLine(field) {
+	const builder = BUILDER_BY_TYPE[field.type] ?? "textField";
+	const parts = [];
+	if (builder === "entityField" && field.url) parts.push(`${builder}('${field.url}', '${field.valueField || "_iri"}', '${field.textField || "name"}')`);
+	else if (builder === "enumField" && field.data.length > 0) {
+		const options = field.data.map((opt) => `{ value: ${JSON.stringify(opt.value)}, text: ${JSON.stringify(opt.text)} }`).join(", ");
+		parts.push(`${builder}([${options}])`);
+	} else if (builder === "fileField" || builder === "imageField") parts.push(`${builder}('${field.url ?? "/api/media"}')`);
+	else parts.push(`${builder}()`);
+	let chain = parts[0] + `.name('${field.name}').label(${JSON.stringify(field.label)})`;
+	if (field.required) chain += ".required(true)";
+	if (field.readonly) chain += ".readonly(true)";
+	if (field.precision !== void 0 && field.type === "number") chain += `.precision(${field.precision})`;
+	chain += ".build()";
+	return `    ${chain},`;
+}
+function renderFieldsModule(apiUrl, fields) {
+	const hintable = fields.filter((f) => !f.isIdentity);
+	const imports = new Set(["defineResource"]);
+	for (const field of hintable) {
+		const builder = BUILDER_BY_TYPE[field.type] ?? "textField";
+		imports.add(builder);
+	}
+	return `import { ${[...imports].join(", ")} } from '@nubitio/react-admin';
+
+/** Ejected from ${apiUrl} — ${(/* @__PURE__ */ new Date()).toISOString()} */
+export const resource = defineResource('${apiUrl}', {
+  fields: [
+${hintable.map(fieldToCodeLine).join("\n")}
+  ],
+});
+`;
+}
+function renderPageModule(componentName, apiUrl, title) {
+	return `import { SmartCrudPage, defineResource } from '@nubitio/react-admin';
+
+const resource = defineResource('${apiUrl}', {
+  title: ${JSON.stringify(title)},
+});
+
+export function ${componentName}() {
+  return <SmartCrudPage resource={resource} />;
+}
+`;
+}
+//#endregion
+//#region packages/eject/src/runCli.ts
+async function runCli(ctx) {
+	const { command, target, rest, flag, writeFileSync, resolve } = ctx;
+	if (!command || command === "--help" || command === "-h") {
+		console.log(`Usage:
+  nubit eject fields <apiUrl> [--docs http://localhost:8000/api/docs.jsonld] [--out file.ts]
+  nubit eject page <Name> <apiUrl> [--docs ...] [--out Pages/Name.tsx] [--title "Title"]
+`);
+		return;
+	}
+	const docsUrl = flag("--docs", "http://localhost:8000/api/docs.jsonld");
+	const outPath = flag("--out", "");
+	if (command === "eject" && target === "fields") {
+		const apiUrl = rest.find((arg) => !arg.startsWith("--") && arg !== docsUrl && arg !== outPath);
+		if (!apiUrl) throw new Error("Missing apiUrl argument");
+		const result = await ejectFieldsFromDocs(apiUrl, docsUrl);
+		const code = renderFieldsModule(result.apiUrl, result.fields);
+		if (outPath) {
+			writeFileSync(resolve(outPath), code);
+			console.log(`Wrote ${outPath} (${result.className}, ${result.fields.length} fields)`);
+		} else console.log(code);
+		return;
+	}
+	if (command === "eject" && target === "page") {
+		const [componentName, apiUrl] = rest.filter((arg) => !arg.startsWith("--") && arg !== docsUrl && arg !== outPath);
+		if (!componentName || !apiUrl) throw new Error("Usage: nubit eject page <ComponentName> <apiUrl>");
+		const code = renderPageModule(componentName, apiUrl, flag("--title", componentName.replace(/Page$/, "")));
+		if (outPath) {
+			writeFileSync(resolve(outPath), code);
+			console.log(`Wrote ${outPath}`);
+		} else console.log(code);
+		return;
+	}
+	throw new Error(`Unknown command: ${command} ${target ?? ""}`);
+}
+//#endregion
+export { ejectFieldsFromDocs, fieldToCodeLine, renderFieldsModule, renderPageModule, runCli };

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@nubitio/eject",
+  "version": "0.6.1",
+  "description": "Eject explicit resource definitions from Hydra API docs",
+  "license": "MIT",
+  "type": "module",
+  "keywords": [
+    "nubit",
+    "hydra",
+    "api-platform",
+    "codegen",
+    "cli"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nubitio/nubit-react.git",
+    "directory": "packages/eject"
+  },
+  "bugs": {
+    "url": "https://github.com/nubitio/nubit-react/issues"
+  },
+  "homepage": "https://github.com/nubitio/nubit-react/tree/main/packages/eject#readme",
+  "bin": {
+    "nubit": "./bin/nubit.mjs"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": {
+        "import": "./dist/index.d.mts",
+        "require": "./dist/index.d.cts"
+      },
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@nubitio/crud": "0.6.1",
+    "@nubitio/hydra": "0.6.1"
+  }
+}