@navios/adapter-xml 0.1.0 → 0.7.0

package/dist/tsdown.config.d.mts

@@ -0,0 +1,3 @@
+declare const _default: import("tsdown").UserConfig;
+export default _default;
+//# sourceMappingURL=tsdown.config.d.mts.map

package/dist/tsdown.config.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsdown.config.d.mts","sourceRoot":"","sources":["../tsdown.config.mts"],"names":[],"mappings":";AAIA,wBAkCE"}

package/dist/vitest.e2e.fastify.config.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"vitest.e2e.fastify.config.d.mts","sourceRoot":"","sources":["../vitest.e2e.fastify.config.mts"],"names":[],"mappings":";AAGA,wBAmBE"}
+{"version":3,"file":"vitest.e2e.fastify.config.d.mts","sourceRoot":"","sources":["../vitest.e2e.fastify.config.mts"],"names":[],"mappings":";AAIA,wBAwBE"}

package/lib/create-element--Gd2L8UR.d.cts

@@ -0,0 +1,26 @@
+import { c as Fragment, d as XmlNode, f as ComponentClass, r as AsyncXmlNode, s as ClassComponentNode } from "./xml-node-CddziLym.cjs";
+
+//#region src/runtime/create-element.d.mts
+type SyncComponent = (props: any) => XmlNode | AsyncXmlNode | ClassComponentNode;
+type AsyncComponentFn = (props: any) => Promise<XmlNode | AsyncXmlNode | ClassComponentNode>;
+type FunctionalComponent = SyncComponent | AsyncComponentFn;
+type ComponentType = FunctionalComponent | ComponentClass;
+/**
+ * JSX automatic runtime function.
+ * Used by the JSX transformer when jsxImportSource is set.
+ * Children are passed as part of props.children.
+ */
+declare function jsx(type: string | typeof Fragment | ComponentType, props: Record<string, unknown> | null): XmlNode | AsyncXmlNode | ClassComponentNode;
+/**
+ * JSX automatic runtime function for static children.
+ * Identical to jsx() for XML - React uses this for optimization hints.
+ */
+declare const jsxs: typeof jsx;
+/**
+ * Classic createElement for manual usage.
+ * Children are passed as rest arguments.
+ */
+declare function createElement(type: string | typeof Fragment | ComponentType, props: Record<string, unknown> | null, ...children: any[]): XmlNode | AsyncXmlNode | ClassComponentNode;
+//#endregion
+export { jsx as n, jsxs as r, createElement as t };
+//# sourceMappingURL=create-element--Gd2L8UR.d.cts.map

package/lib/create-element--Gd2L8UR.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-element--Gd2L8UR.d.cts","names":[],"sources":["../src/runtime/create-element.mts"],"sourcesContent":[],"mappings":";;;AAIgF,KAE3E,aAAA,GAAa,CAAA,KAAA,EAAA,GAAA,EAAA,GAAmB,OAAnB,GAA6B,YAA7B,GAA4C,kBAA5C;KACb,gBAAA,GADgC,CAAA,KAAA,EAAA,GAAA,EAAA,GACG,OADH,CACW,OADX,GACqB,YADrB,GACoC,kBADpC,CAAA;KAEhC,mBAAA,GAAsB,aAFoB,GAEJ,gBAFI;KAG1C,aAAA,GAAgB,mBAHyC,GAGnB,cAHmB;;AAAkB;;;;AACxC,iBAmBxB,GAAA,CAnBwB,IAAA,EAAA,MAAA,GAAA,OAoBhB,QApBgB,GAoBL,aApBK,EAAA,KAAA,EAqB/B,MArB+B,CAAA,MAAA,EAAA,OAAA,CAAA,GAAA,IAAA,CAAA,EAsBrC,OAtBqC,GAsB3B,YAtB2B,GAsBZ,kBAtBY;;AAAO;AACY;AAkB3D;AACwB,cAyCX,IAzCW,EAAA,OAyCP,GAzCO;;;;;AAEI,iBA6CZ,aAAA,CA7CY,IAAA,EAAA,MAAA,GAAA,OA8CJ,QA9CI,GA8CO,aA9CP,EAAA,KAAA,EA+CnB,MA/CmB,CAAA,MAAA,EAAA,OAAA,CAAA,GAAA,IAAA,EAAA,GAAA,QAAA,EAAA,GAAA,EAAA,CAAA,EAiDzB,OAjDyB,GAiDf,YAjDe,GAiDA,kBAjDA"}

package/lib/create-element-61MP7_99.d.mts

@@ -0,0 +1,26 @@
+import { c as Fragment, d as XmlNode, f as ComponentClass, r as AsyncXmlNode, s as ClassComponentNode } from "./xml-node-BQA44ydQ.mjs";
+
+//#region src/runtime/create-element.d.mts
+type SyncComponent = (props: any) => XmlNode | AsyncXmlNode | ClassComponentNode;
+type AsyncComponentFn = (props: any) => Promise<XmlNode | AsyncXmlNode | ClassComponentNode>;
+type FunctionalComponent = SyncComponent | AsyncComponentFn;
+type ComponentType = FunctionalComponent | ComponentClass;
+/**
+ * JSX automatic runtime function.
+ * Used by the JSX transformer when jsxImportSource is set.
+ * Children are passed as part of props.children.
+ */
+declare function jsx(type: string | typeof Fragment | ComponentType, props: Record<string, unknown> | null): XmlNode | AsyncXmlNode | ClassComponentNode;
+/**
+ * JSX automatic runtime function for static children.
+ * Identical to jsx() for XML - React uses this for optimization hints.
+ */
+declare const jsxs: typeof jsx;
+/**
+ * Classic createElement for manual usage.
+ * Children are passed as rest arguments.
+ */
+declare function createElement(type: string | typeof Fragment | ComponentType, props: Record<string, unknown> | null, ...children: any[]): XmlNode | AsyncXmlNode | ClassComponentNode;
+//#endregion
+export { jsx as n, jsxs as r, createElement as t };
+//# sourceMappingURL=create-element-61MP7_99.d.mts.map

package/lib/create-element-61MP7_99.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-element-61MP7_99.d.mts","names":[],"sources":["../src/runtime/create-element.mts"],"sourcesContent":[],"mappings":";;;AAIgF,KAE3E,aAAA,GAAa,CAAA,KAAA,EAAA,GAAA,EAAA,GAAmB,OAAnB,GAA6B,YAA7B,GAA4C,kBAA5C;KACb,gBAAA,GADgC,CAAA,KAAA,EAAA,GAAA,EAAA,GACG,OADH,CACW,OADX,GACqB,YADrB,GACoC,kBADpC,CAAA;KAEhC,mBAAA,GAAsB,aAFoB,GAEJ,gBAFI;KAG1C,aAAA,GAAgB,mBAHyC,GAGnB,cAHmB;;AAAkB;;;;AACxC,iBAmBxB,GAAA,CAnBwB,IAAA,EAAA,MAAA,GAAA,OAoBhB,QApBgB,GAoBL,aApBK,EAAA,KAAA,EAqB/B,MArB+B,CAAA,MAAA,EAAA,OAAA,CAAA,GAAA,IAAA,CAAA,EAsBrC,OAtBqC,GAsB3B,YAtB2B,GAsBZ,kBAtBY;;AAAO;AACY;AAkB3D;AACwB,cAyCX,IAzCW,EAAA,OAyCP,GAzCO;;;;;AAEI,iBA6CZ,aAAA,CA7CY,IAAA,EAAA,MAAA,GAAA,OA8CJ,QA9CI,GA8CO,aA9CP,EAAA,KAAA,EA+CnB,MA/CmB,CAAA,MAAA,EAAA,OAAA,CAAA,GAAA,IAAA,EAAA,GAAA,QAAA,EAAA,GAAA,EAAA,CAAA,EAiDzB,OAjDyB,GAiDf,YAjDe,GAiDA,kBAjDA"}

package/lib/create-element-CTOxv6Df.cjs

@@ -0,0 +1,183 @@
+let __navios_core = require("@navios/core");
+
+//#region src/types/xml-node.mts
+const Fragment = Symbol.for("xml.fragment");
+const AsyncComponent = Symbol.for("xml.async");
+const CDataSymbol = Symbol.for("xml.cdata");
+const RawXmlSymbol = Symbol.for("xml.raw");
+const ClassComponent = Symbol.for("xml.class-component");
+
+//#endregion
+//#region src/decorators/component.decorator.mts
+const ComponentMeta = Symbol.for("xml.component.meta");
+function Component(options = {}) {
+	const { schema, registry = __navios_core.globalRegistry } = options;
+	return (target, context) => {
+		if (context && context.kind !== "class" || target instanceof Function && !context) throw new Error("[@navios/adapter-xml] @Component decorator can only be used on classes.");
+		if (typeof target.prototype.render !== "function") throw new Error(`[@navios/adapter-xml] @Component class "${target.name}" must implement render() method.`);
+		const injectableToken = schema ? __navios_core.InjectionToken.create(target, schema) : __navios_core.InjectionToken.create(target);
+		registry.set(injectableToken, __navios_core.InjectableScope.Request, target, __navios_core.InjectableType.Class);
+		target[__navios_core.InjectableTokenMeta] = injectableToken;
+		target[ComponentMeta] = true;
+		return target;
+	};
+}
+/**
+* Type guard to check if a value is a component class.
+*
+* Component classes are classes decorated with `@Component` that implement
+* the `XmlComponent` interface.
+*
+* @param value - The value to check.
+* @returns `true` if the value is a component class, `false` otherwise.
+*
+* @example
+* ```ts
+* if (isComponentClass(MyClass)) {
+*   // MyClass is a component class
+*   const instance = await container.get(MyClass)
+* }
+* ```
+*/ function isComponentClass(value) {
+	return typeof value === "function" && value[ComponentMeta] === true;
+}
+
+//#endregion
+//#region src/runtime/create-element.mts
+function flattenChildren(children) {
+	if (children == null || children === false) return [];
+	if (Array.isArray(children)) return children.flat(Infinity).filter((c) => c != null && c !== false);
+	return [children];
+}
+/**
+* JSX automatic runtime function.
+* Used by the JSX transformer when jsxImportSource is set.
+* Children are passed as part of props.children.
+*/
+function jsx(type, props) {
+	const { children, ...restProps } = props ?? {};
+	const flatChildren = flattenChildren(children);
+	if (isComponentClass(type)) return {
+		type: ClassComponent,
+		componentClass: type,
+		props: {
+			...restProps,
+			children: flatChildren
+		}
+	};
+	if (typeof type === "function") {
+		const result = type({
+			...restProps,
+			children: flatChildren
+		});
+		if (result instanceof Promise) return {
+			type: AsyncComponent,
+			promise: result
+		};
+		return result;
+	}
+	return {
+		type,
+		props: restProps,
+		children: flatChildren
+	};
+}
+/**
+* JSX automatic runtime function for static children.
+* Identical to jsx() for XML - React uses this for optimization hints.
+*/
+const jsxs = jsx;
+/**
+* Classic createElement for manual usage.
+* Children are passed as rest arguments.
+*/
+function createElement(type, props, ...children) {
+	const flatChildren = flattenChildren(children);
+	if (isComponentClass(type)) return {
+		type: ClassComponent,
+		componentClass: type,
+		props: {
+			...props,
+			children: flatChildren
+		}
+	};
+	if (typeof type === "function") {
+		const result = type({
+			...props,
+			children: flatChildren
+		});
+		if (result instanceof Promise) return {
+			type: AsyncComponent,
+			promise: result
+		};
+		return result;
+	}
+	return {
+		type,
+		props: props ?? {},
+		children: flatChildren
+	};
+}
+
+//#endregion
+Object.defineProperty(exports, 'AsyncComponent', {
+  enumerable: true,
+  get: function () {
+    return AsyncComponent;
+  }
+});
+Object.defineProperty(exports, 'CDataSymbol', {
+  enumerable: true,
+  get: function () {
+    return CDataSymbol;
+  }
+});
+Object.defineProperty(exports, 'ClassComponent', {
+  enumerable: true,
+  get: function () {
+    return ClassComponent;
+  }
+});
+Object.defineProperty(exports, 'Component', {
+  enumerable: true,
+  get: function () {
+    return Component;
+  }
+});
+Object.defineProperty(exports, 'Fragment', {
+  enumerable: true,
+  get: function () {
+    return Fragment;
+  }
+});
+Object.defineProperty(exports, 'RawXmlSymbol', {
+  enumerable: true,
+  get: function () {
+    return RawXmlSymbol;
+  }
+});
+Object.defineProperty(exports, 'createElement', {
+  enumerable: true,
+  get: function () {
+    return createElement;
+  }
+});
+Object.defineProperty(exports, 'isComponentClass', {
+  enumerable: true,
+  get: function () {
+    return isComponentClass;
+  }
+});
+Object.defineProperty(exports, 'jsx', {
+  enumerable: true,
+  get: function () {
+    return jsx;
+  }
+});
+Object.defineProperty(exports, 'jsxs', {
+  enumerable: true,
+  get: function () {
+    return jsxs;
+  }
+});
+//# sourceMappingURL=create-element-CTOxv6Df.cjs.map

package/lib/create-element-CTOxv6Df.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-element-CTOxv6Df.cjs","names":["globalRegistry","InjectableScope","InjectableTokenMeta","InjectableType","InjectionToken","ComponentMeta","Symbol","for","Component","options","schema","registry","target","context","kind","Function","Error","prototype","render","name","injectableToken","create","set","Request","Class","isComponentClass","value"],"sources":["../src/types/xml-node.mts","../src/decorators/component.decorator.mts","../src/runtime/create-element.mts"],"sourcesContent":["import type { ComponentClass } from './component.mjs'\n\nexport const Fragment = Symbol.for('xml.fragment')\nexport const AsyncComponent = Symbol.for('xml.async')\nexport const CDataSymbol = Symbol.for('xml.cdata')\nexport const RawXmlSymbol = Symbol.for('xml.raw')\nexport const ClassComponent = Symbol.for('xml.class-component')\n\n/** Represents a CDATA section - content is wrapped in <![CDATA[...]]> */\nexport interface CDataNode {\n  type: typeof CDataSymbol\n  content: string\n}\n\n/** Represents raw XML content - inserted without any escaping or wrapping */\nexport interface RawXmlNode {\n  type: typeof RawXmlSymbol\n  content: string\n}\n\n/** Represents a class component that needs to be resolved via DI */\nexport interface ClassComponentNode {\n  type: typeof ClassComponent\n  componentClass: ComponentClass\n  props: Record<string, unknown>\n}\n\nexport interface XmlNode {\n  type: string | typeof Fragment\n  props: Record<string, unknown>\n  children: AnyXmlNode[]\n}\n\n/** Represents an async component that needs to be resolved before rendering */\nexport interface AsyncXmlNode {\n  type: typeof AsyncComponent\n  promise: Promise<AnyXmlNode>\n}\n\n/** Union type for all possible node types */\nexport type AnyXmlNode =\n  | XmlNode\n  | AsyncXmlNode\n  | CDataNode\n  | RawXmlNode\n  | ClassComponentNode\n  | string\n  | number\n  | null\n  | undefined\n","import type { Registry } from '@navios/core'\nimport type { z, ZodObject, ZodRawShape } from 'zod/v4'\n\nimport {\n  globalRegistry,\n  InjectableScope,\n  InjectableTokenMeta,\n  InjectableType,\n  InjectionToken,\n} from '@navios/core'\n\nimport type { ComponentClass, XmlComponent } from '../types/component.mjs'\n\nexport const ComponentMeta = Symbol.for('xml.component.meta')\n\n/**\n * Decorator for class-based XML components with dependency injection support.\n *\n * Class components must implement the `XmlComponent` interface with a `render()` method.\n * They can optionally accept props via constructor, validated with a Zod schema.\n *\n * @overload\n * Component without props (no schema).\n *\n * @example\n * ```tsx\n * @Component()\n * class LatestPostsComponent implements XmlComponent {\n *   private readonly postService = inject(PostService)\n *\n *   async render() {\n *     const posts = await this.postService.getLatestPosts()\n *     return <>{posts.map(post => <item>...</item>)}</>\n *   }\n * }\n * ```\n *\n * @overload\n * Component with props schema for type-safe props.\n *\n * @param options - Configuration object with schema and optional registry.\n * @param options.schema - Zod schema for validating and typing component props.\n * @param options.registry - Optional custom DI registry (defaults to global registry).\n *\n * @example\n * ```tsx\n * const DescriptionSchema = z.object({\n *   content: z.string(),\n *   wrapInCData: z.boolean().optional(),\n * })\n *\n * @Component({ schema: DescriptionSchema })\n * class DescriptionComponent implements XmlComponent {\n *   constructor(private props: z.output<typeof DescriptionSchema>) {}\n *\n *   async render() {\n *     return <description>{this.props.wrapInCData ? <CData>{this.props.content}</CData> : this.props.content}</description>\n *   }\n * }\n * ```\n *\n * @overload\n * Component with custom registry only (no props).\n *\n * @param options - Configuration object with registry.\n * @param options.registry - Custom DI registry to use for this component.\n */\n// #1 Component without props (no schema)\nexport function Component(): <T extends ComponentClass>(\n  target: T,\n  context?: ClassDecoratorContext,\n) => T\n\n// #2 Component with props schema\nexport function Component<Schema extends ZodObject<ZodRawShape>>(options: {\n  schema: Schema\n  registry?: Registry\n}): <T extends new (props: z.output<Schema>, ...args: any[]) => XmlComponent>(\n  target: T,\n  context?: ClassDecoratorContext,\n) => T\n\n// #3 Component with custom registry only\nexport function Component(options: {\n  registry: Registry\n}): <T extends ComponentClass>(target: T, context?: ClassDecoratorContext) => T\n\nexport function Component(\n  options: {\n    schema?: ZodObject<ZodRawShape>\n    registry?: Registry\n  } = {},\n) {\n  const { schema, registry = globalRegistry } = options\n\n  return <T extends ComponentClass>(\n    target: T,\n    context?: ClassDecoratorContext,\n  ): T => {\n    if (\n      (context && context.kind !== 'class') ||\n      (target instanceof Function && !context)\n    ) {\n      throw new Error(\n        '[@navios/adapter-xml] @Component decorator can only be used on classes.',\n      )\n    }\n\n    // Verify the class has a render method\n    if (typeof target.prototype.render !== 'function') {\n      throw new Error(\n        `[@navios/adapter-xml] @Component class \"${target.name}\" must implement render() method.`,\n      )\n    }\n\n    // Create token with schema if provided\n    const injectableToken = schema\n      ? InjectionToken.create(target, schema)\n      : InjectionToken.create(target)\n\n    // Register with Request scope - each render gets fresh instances\n    registry.set(\n      injectableToken,\n      InjectableScope.Request,\n      target,\n      InjectableType.Class,\n    )\n\n    // Store token metadata on the class (same pattern as @Injectable)\n    // @ts-expect-error - Adding metadata to class\n    target[InjectableTokenMeta] = injectableToken\n\n    // Mark as component for JSX runtime detection\n    // @ts-expect-error - Adding metadata to class\n    target[ComponentMeta] = true\n\n    return target\n  }\n}\n\n/**\n * Type guard to check if a value is a component class.\n *\n * Component classes are classes decorated with `@Component` that implement\n * the `XmlComponent` interface.\n *\n * @param value - The value to check.\n * @returns `true` if the value is a component class, `false` otherwise.\n *\n * @example\n * ```ts\n * if (isComponentClass(MyClass)) {\n *   // MyClass is a component class\n *   const instance = await container.get(MyClass)\n * }\n * ```\n */\nexport function isComponentClass(value: unknown): value is ComponentClass {\n  return (\n    typeof value === 'function' &&\n    // @ts-expect-error - Checking metadata\n    value[ComponentMeta] === true\n  )\n}\n","import type { AnyXmlNode, AsyncXmlNode, ClassComponentNode, XmlNode } from '../types/xml-node.mjs'\nimport type { ComponentClass } from '../types/component.mjs'\n\nimport { isComponentClass } from '../decorators/component.decorator.mjs'\nimport { AsyncComponent, ClassComponent, Fragment } from '../types/xml-node.mjs'\n\ntype SyncComponent = (props: any) => XmlNode | AsyncXmlNode | ClassComponentNode\ntype AsyncComponentFn = (props: any) => Promise<XmlNode | AsyncXmlNode | ClassComponentNode>\ntype FunctionalComponent = SyncComponent | AsyncComponentFn\ntype ComponentType = FunctionalComponent | ComponentClass\n\nfunction flattenChildren(children: any): AnyXmlNode[] {\n  if (children == null || children === false) {\n    return []\n  }\n  if (Array.isArray(children)) {\n    return children.flat(Infinity).filter((c) => c != null && c !== false)\n  }\n  return [children]\n}\n\n/**\n * JSX automatic runtime function.\n * Used by the JSX transformer when jsxImportSource is set.\n * Children are passed as part of props.children.\n */\nexport function jsx(\n  type: string | typeof Fragment | ComponentType,\n  props: Record<string, unknown> | null,\n): XmlNode | AsyncXmlNode | ClassComponentNode {\n  const { children, ...restProps } = props ?? {}\n  const flatChildren = flattenChildren(children)\n\n  // Handle class components - create ClassComponentNode for later resolution\n  if (isComponentClass(type)) {\n    return {\n      type: ClassComponent,\n      componentClass: type,\n      props: { ...restProps, children: flatChildren },\n    }\n  }\n\n  // Handle function components (sync or async)\n  if (typeof type === 'function') {\n    const result = type({ ...restProps, children: flatChildren })\n\n    // If component returns a Promise, wrap it in AsyncXmlNode\n    if (result instanceof Promise) {\n      return {\n        type: AsyncComponent,\n        promise: result,\n      }\n    }\n\n    return result\n  }\n\n  return {\n    type,\n    props: restProps,\n    children: flatChildren,\n  }\n}\n\n/**\n * JSX automatic runtime function for static children.\n * Identical to jsx() for XML - React uses this for optimization hints.\n */\nexport const jsxs = jsx\n\n/**\n * Classic createElement for manual usage.\n * Children are passed as rest arguments.\n */\nexport function createElement(\n  type: string | typeof Fragment | ComponentType,\n  props: Record<string, unknown> | null,\n  ...children: any[]\n): XmlNode | AsyncXmlNode | ClassComponentNode {\n  const flatChildren = flattenChildren(children)\n\n  // Handle class components - create ClassComponentNode for later resolution\n  if (isComponentClass(type)) {\n    return {\n      type: ClassComponent,\n      componentClass: type,\n      props: { ...props, children: flatChildren },\n    }\n  }\n\n  // Handle function components (sync or async)\n  if (typeof type === 'function') {\n    const result = type({ ...props, children: flatChildren })\n\n    // If component returns a Promise, wrap it in AsyncXmlNode\n    if (result instanceof Promise) {\n      return {\n        type: AsyncComponent,\n        promise: result,\n      }\n    }\n\n    return result\n  }\n\n  return {\n    type,\n    props: props ?? {},\n    children: flatChildren,\n  }\n}\n\nexport { Fragment }\n"],"mappings":";;;AAEA,MAAa,WAAW,OAAO,IAAI,eAAe;AAClD,MAAa,iBAAiB,OAAO,IAAI,YAAY;AACrD,MAAa,cAAc,OAAO,IAAI,YAAY;AAClD,MAAa,eAAe,OAAO,IAAI,UAAU;AACjD,MAAa,iBAAiB,OAAO,IAAI,sBAAsB;;;;ACO/D,MAAaK,gBAAgBC,OAAOC,IAAI,qBAAA;AA0ExC,SAAgBC,UACdC,UAGI,EAAE,EAAA;CAEN,MAAM,EAAEC,QAAQC,WAAWX,iCAAmBS;AAE9C,SACEG,QACAC,YAAAA;AAEA,MACE,WAAYA,QAAQC,SAAS,WAC5BF,kBAAkBG,YAAY,CAACF,QAEhC,OAAM,IAAIG,MACR,0EAAA;AAKJ,MAAI,OAAOJ,OAAOK,UAAUC,WAAW,WACrC,OAAM,IAAIF,MACR,2CAA2CJ,OAAOO,KAAK,mCAAkC;EAK7F,MAAMC,kBAAkBV,SACpBN,6BAAeiB,OAAOT,QAAQF,OAAAA,GAC9BN,6BAAeiB,OAAOT,OAAAA;AAG1BD,WAASW,IACPF,iBACAnB,8BAAgBsB,SAChBX,QACAT,6BAAeqB,MAAK;AAKtBZ,SAAOV,qCAAuBkB;AAI9BR,SAAOP,iBAAiB;AAExB,SAAOO;;;;;;;;;;;;;;;;;;;GAqBX,SAAgBa,iBAAiBC,OAAc;AAC7C,QACE,OAAOA,UAAU,cAEjBA,MAAMrB,mBAAmB;;;;;ACtJ7B,SAAS,gBAAgB,UAA6B;AACpD,KAAI,YAAY,QAAQ,aAAa,MACnC,QAAO,EAAE;AAEX,KAAI,MAAM,QAAQ,SAAS,CACzB,QAAO,SAAS,KAAK,SAAS,CAAC,QAAQ,MAAM,KAAK,QAAQ,MAAM,MAAM;AAExE,QAAO,CAAC,SAAS;;;;;;;AAQnB,SAAgB,IACd,MACA,OAC6C;CAC7C,MAAM,EAAE,UAAU,GAAG,cAAc,SAAS,EAAE;CAC9C,MAAM,eAAe,gBAAgB,SAAS;AAG9C,KAAI,iBAAiB,KAAK,CACxB,QAAO;EACL,MAAM;EACN,gBAAgB;EAChB,OAAO;GAAE,GAAG;GAAW,UAAU;GAAc;EAChD;AAIH,KAAI,OAAO,SAAS,YAAY;EAC9B,MAAM,SAAS,KAAK;GAAE,GAAG;GAAW,UAAU;GAAc,CAAC;AAG7D,MAAI,kBAAkB,QACpB,QAAO;GACL,MAAM;GACN,SAAS;GACV;AAGH,SAAO;;AAGT,QAAO;EACL;EACA,OAAO;EACP,UAAU;EACX;;;;;;AAOH,MAAa,OAAO;;;;;AAMpB,SAAgB,cACd,MACA,OACA,GAAG,UAC0C;CAC7C,MAAM,eAAe,gBAAgB,SAAS;AAG9C,KAAI,iBAAiB,KAAK,CACxB,QAAO;EACL,MAAM;EACN,gBAAgB;EAChB,OAAO;GAAE,GAAG;GAAO,UAAU;GAAc;EAC5C;AAIH,KAAI,OAAO,SAAS,YAAY;EAC9B,MAAM,SAAS,KAAK;GAAE,GAAG;GAAO,UAAU;GAAc,CAAC;AAGzD,MAAI,kBAAkB,QACpB,QAAO;GACL,MAAM;GACN,SAAS;GACV;AAGH,SAAO;;AAGT,QAAO;EACL;EACA,OAAO,SAAS,EAAE;EAClB,UAAU;EACX"}

package/lib/create-element-NZEYaRw5.mjs

@@ -0,0 +1,124 @@
+import { InjectableScope, InjectableTokenMeta, InjectableType, InjectionToken, globalRegistry } from "@navios/core";
+
+//#region src/types/xml-node.mts
+const Fragment = Symbol.for("xml.fragment");
+const AsyncComponent = Symbol.for("xml.async");
+const CDataSymbol = Symbol.for("xml.cdata");
+const RawXmlSymbol = Symbol.for("xml.raw");
+const ClassComponent = Symbol.for("xml.class-component");
+
+//#endregion
+//#region src/decorators/component.decorator.mts
+const ComponentMeta = Symbol.for("xml.component.meta");
+function Component(options = {}) {
+	const { schema, registry = globalRegistry } = options;
+	return (target, context) => {
+		if (context && context.kind !== "class" || target instanceof Function && !context) throw new Error("[@navios/adapter-xml] @Component decorator can only be used on classes.");
+		if (typeof target.prototype.render !== "function") throw new Error(`[@navios/adapter-xml] @Component class "${target.name}" must implement render() method.`);
+		const injectableToken = schema ? InjectionToken.create(target, schema) : InjectionToken.create(target);
+		registry.set(injectableToken, InjectableScope.Request, target, InjectableType.Class);
+		target[InjectableTokenMeta] = injectableToken;
+		target[ComponentMeta] = true;
+		return target;
+	};
+}
+/**
+* Type guard to check if a value is a component class.
+*
+* Component classes are classes decorated with `@Component` that implement
+* the `XmlComponent` interface.
+*
+* @param value - The value to check.
+* @returns `true` if the value is a component class, `false` otherwise.
+*
+* @example
+* ```ts
+* if (isComponentClass(MyClass)) {
+*   // MyClass is a component class
+*   const instance = await container.get(MyClass)
+* }
+* ```
+*/ function isComponentClass(value) {
+	return typeof value === "function" && value[ComponentMeta] === true;
+}
+
+//#endregion
+//#region src/runtime/create-element.mts
+function flattenChildren(children) {
+	if (children == null || children === false) return [];
+	if (Array.isArray(children)) return children.flat(Infinity).filter((c) => c != null && c !== false);
+	return [children];
+}
+/**
+* JSX automatic runtime function.
+* Used by the JSX transformer when jsxImportSource is set.
+* Children are passed as part of props.children.
+*/
+function jsx(type, props) {
+	const { children, ...restProps } = props ?? {};
+	const flatChildren = flattenChildren(children);
+	if (isComponentClass(type)) return {
+		type: ClassComponent,
+		componentClass: type,
+		props: {
+			...restProps,
+			children: flatChildren
+		}
+	};
+	if (typeof type === "function") {
+		const result = type({
+			...restProps,
+			children: flatChildren
+		});
+		if (result instanceof Promise) return {
+			type: AsyncComponent,
+			promise: result
+		};
+		return result;
+	}
+	return {
+		type,
+		props: restProps,
+		children: flatChildren
+	};
+}
+/**
+* JSX automatic runtime function for static children.
+* Identical to jsx() for XML - React uses this for optimization hints.
+*/
+const jsxs = jsx;
+/**
+* Classic createElement for manual usage.
+* Children are passed as rest arguments.
+*/
+function createElement(type, props, ...children) {
+	const flatChildren = flattenChildren(children);
+	if (isComponentClass(type)) return {
+		type: ClassComponent,
+		componentClass: type,
+		props: {
+			...props,
+			children: flatChildren
+		}
+	};
+	if (typeof type === "function") {
+		const result = type({
+			...props,
+			children: flatChildren
+		});
+		if (result instanceof Promise) return {
+			type: AsyncComponent,
+			promise: result
+		};
+		return result;
+	}
+	return {
+		type,
+		props: props ?? {},
+		children: flatChildren
+	};
+}
+
+//#endregion
+export { isComponentClass as a, ClassComponent as c, Component as i, Fragment as l, jsx as n, AsyncComponent as o, jsxs as r, CDataSymbol as s, createElement as t, RawXmlSymbol as u };
+//# sourceMappingURL=create-element-NZEYaRw5.mjs.map

package/lib/create-element-NZEYaRw5.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-element-NZEYaRw5.mjs","names":["globalRegistry","InjectableScope","InjectableTokenMeta","InjectableType","InjectionToken","ComponentMeta","Symbol","for","Component","options","schema","registry","target","context","kind","Function","Error","prototype","render","name","injectableToken","create","set","Request","Class","isComponentClass","value"],"sources":["../src/types/xml-node.mts","../src/decorators/component.decorator.mts","../src/runtime/create-element.mts"],"sourcesContent":["import type { ComponentClass } from './component.mjs'\n\nexport const Fragment = Symbol.for('xml.fragment')\nexport const AsyncComponent = Symbol.for('xml.async')\nexport const CDataSymbol = Symbol.for('xml.cdata')\nexport const RawXmlSymbol = Symbol.for('xml.raw')\nexport const ClassComponent = Symbol.for('xml.class-component')\n\n/** Represents a CDATA section - content is wrapped in <![CDATA[...]]> */\nexport interface CDataNode {\n  type: typeof CDataSymbol\n  content: string\n}\n\n/** Represents raw XML content - inserted without any escaping or wrapping */\nexport interface RawXmlNode {\n  type: typeof RawXmlSymbol\n  content: string\n}\n\n/** Represents a class component that needs to be resolved via DI */\nexport interface ClassComponentNode {\n  type: typeof ClassComponent\n  componentClass: ComponentClass\n  props: Record<string, unknown>\n}\n\nexport interface XmlNode {\n  type: string | typeof Fragment\n  props: Record<string, unknown>\n  children: AnyXmlNode[]\n}\n\n/** Represents an async component that needs to be resolved before rendering */\nexport interface AsyncXmlNode {\n  type: typeof AsyncComponent\n  promise: Promise<AnyXmlNode>\n}\n\n/** Union type for all possible node types */\nexport type AnyXmlNode =\n  | XmlNode\n  | AsyncXmlNode\n  | CDataNode\n  | RawXmlNode\n  | ClassComponentNode\n  | string\n  | number\n  | null\n  | undefined\n","import type { Registry } from '@navios/core'\nimport type { z, ZodObject, ZodRawShape } from 'zod/v4'\n\nimport {\n  globalRegistry,\n  InjectableScope,\n  InjectableTokenMeta,\n  InjectableType,\n  InjectionToken,\n} from '@navios/core'\n\nimport type { ComponentClass, XmlComponent } from '../types/component.mjs'\n\nexport const ComponentMeta = Symbol.for('xml.component.meta')\n\n/**\n * Decorator for class-based XML components with dependency injection support.\n *\n * Class components must implement the `XmlComponent` interface with a `render()` method.\n * They can optionally accept props via constructor, validated with a Zod schema.\n *\n * @overload\n * Component without props (no schema).\n *\n * @example\n * ```tsx\n * @Component()\n * class LatestPostsComponent implements XmlComponent {\n *   private readonly postService = inject(PostService)\n *\n *   async render() {\n *     const posts = await this.postService.getLatestPosts()\n *     return <>{posts.map(post => <item>...</item>)}</>\n *   }\n * }\n * ```\n *\n * @overload\n * Component with props schema for type-safe props.\n *\n * @param options - Configuration object with schema and optional registry.\n * @param options.schema - Zod schema for validating and typing component props.\n * @param options.registry - Optional custom DI registry (defaults to global registry).\n *\n * @example\n * ```tsx\n * const DescriptionSchema = z.object({\n *   content: z.string(),\n *   wrapInCData: z.boolean().optional(),\n * })\n *\n * @Component({ schema: DescriptionSchema })\n * class DescriptionComponent implements XmlComponent {\n *   constructor(private props: z.output<typeof DescriptionSchema>) {}\n *\n *   async render() {\n *     return <description>{this.props.wrapInCData ? <CData>{this.props.content}</CData> : this.props.content}</description>\n *   }\n * }\n * ```\n *\n * @overload\n * Component with custom registry only (no props).\n *\n * @param options - Configuration object with registry.\n * @param options.registry - Custom DI registry to use for this component.\n */\n// #1 Component without props (no schema)\nexport function Component(): <T extends ComponentClass>(\n  target: T,\n  context?: ClassDecoratorContext,\n) => T\n\n// #2 Component with props schema\nexport function Component<Schema extends ZodObject<ZodRawShape>>(options: {\n  schema: Schema\n  registry?: Registry\n}): <T extends new (props: z.output<Schema>, ...args: any[]) => XmlComponent>(\n  target: T,\n  context?: ClassDecoratorContext,\n) => T\n\n// #3 Component with custom registry only\nexport function Component(options: {\n  registry: Registry\n}): <T extends ComponentClass>(target: T, context?: ClassDecoratorContext) => T\n\nexport function Component(\n  options: {\n    schema?: ZodObject<ZodRawShape>\n    registry?: Registry\n  } = {},\n) {\n  const { schema, registry = globalRegistry } = options\n\n  return <T extends ComponentClass>(\n    target: T,\n    context?: ClassDecoratorContext,\n  ): T => {\n    if (\n      (context && context.kind !== 'class') ||\n      (target instanceof Function && !context)\n    ) {\n      throw new Error(\n        '[@navios/adapter-xml] @Component decorator can only be used on classes.',\n      )\n    }\n\n    // Verify the class has a render method\n    if (typeof target.prototype.render !== 'function') {\n      throw new Error(\n        `[@navios/adapter-xml] @Component class \"${target.name}\" must implement render() method.`,\n      )\n    }\n\n    // Create token with schema if provided\n    const injectableToken = schema\n      ? InjectionToken.create(target, schema)\n      : InjectionToken.create(target)\n\n    // Register with Request scope - each render gets fresh instances\n    registry.set(\n      injectableToken,\n      InjectableScope.Request,\n      target,\n      InjectableType.Class,\n    )\n\n    // Store token metadata on the class (same pattern as @Injectable)\n    // @ts-expect-error - Adding metadata to class\n    target[InjectableTokenMeta] = injectableToken\n\n    // Mark as component for JSX runtime detection\n    // @ts-expect-error - Adding metadata to class\n    target[ComponentMeta] = true\n\n    return target\n  }\n}\n\n/**\n * Type guard to check if a value is a component class.\n *\n * Component classes are classes decorated with `@Component` that implement\n * the `XmlComponent` interface.\n *\n * @param value - The value to check.\n * @returns `true` if the value is a component class, `false` otherwise.\n *\n * @example\n * ```ts\n * if (isComponentClass(MyClass)) {\n *   // MyClass is a component class\n *   const instance = await container.get(MyClass)\n * }\n * ```\n */\nexport function isComponentClass(value: unknown): value is ComponentClass {\n  return (\n    typeof value === 'function' &&\n    // @ts-expect-error - Checking metadata\n    value[ComponentMeta] === true\n  )\n}\n","import type { AnyXmlNode, AsyncXmlNode, ClassComponentNode, XmlNode } from '../types/xml-node.mjs'\nimport type { ComponentClass } from '../types/component.mjs'\n\nimport { isComponentClass } from '../decorators/component.decorator.mjs'\nimport { AsyncComponent, ClassComponent, Fragment } from '../types/xml-node.mjs'\n\ntype SyncComponent = (props: any) => XmlNode | AsyncXmlNode | ClassComponentNode\ntype AsyncComponentFn = (props: any) => Promise<XmlNode | AsyncXmlNode | ClassComponentNode>\ntype FunctionalComponent = SyncComponent | AsyncComponentFn\ntype ComponentType = FunctionalComponent | ComponentClass\n\nfunction flattenChildren(children: any): AnyXmlNode[] {\n  if (children == null || children === false) {\n    return []\n  }\n  if (Array.isArray(children)) {\n    return children.flat(Infinity).filter((c) => c != null && c !== false)\n  }\n  return [children]\n}\n\n/**\n * JSX automatic runtime function.\n * Used by the JSX transformer when jsxImportSource is set.\n * Children are passed as part of props.children.\n */\nexport function jsx(\n  type: string | typeof Fragment | ComponentType,\n  props: Record<string, unknown> | null,\n): XmlNode | AsyncXmlNode | ClassComponentNode {\n  const { children, ...restProps } = props ?? {}\n  const flatChildren = flattenChildren(children)\n\n  // Handle class components - create ClassComponentNode for later resolution\n  if (isComponentClass(type)) {\n    return {\n      type: ClassComponent,\n      componentClass: type,\n      props: { ...restProps, children: flatChildren },\n    }\n  }\n\n  // Handle function components (sync or async)\n  if (typeof type === 'function') {\n    const result = type({ ...restProps, children: flatChildren })\n\n    // If component returns a Promise, wrap it in AsyncXmlNode\n    if (result instanceof Promise) {\n      return {\n        type: AsyncComponent,\n        promise: result,\n      }\n    }\n\n    return result\n  }\n\n  return {\n    type,\n    props: restProps,\n    children: flatChildren,\n  }\n}\n\n/**\n * JSX automatic runtime function for static children.\n * Identical to jsx() for XML - React uses this for optimization hints.\n */\nexport const jsxs = jsx\n\n/**\n * Classic createElement for manual usage.\n * Children are passed as rest arguments.\n */\nexport function createElement(\n  type: string | typeof Fragment | ComponentType,\n  props: Record<string, unknown> | null,\n  ...children: any[]\n): XmlNode | AsyncXmlNode | ClassComponentNode {\n  const flatChildren = flattenChildren(children)\n\n  // Handle class components - create ClassComponentNode for later resolution\n  if (isComponentClass(type)) {\n    return {\n      type: ClassComponent,\n      componentClass: type,\n      props: { ...props, children: flatChildren },\n    }\n  }\n\n  // Handle function components (sync or async)\n  if (typeof type === 'function') {\n    const result = type({ ...props, children: flatChildren })\n\n    // If component returns a Promise, wrap it in AsyncXmlNode\n    if (result instanceof Promise) {\n      return {\n        type: AsyncComponent,\n        promise: result,\n      }\n    }\n\n    return result\n  }\n\n  return {\n    type,\n    props: props ?? {},\n    children: flatChildren,\n  }\n}\n\nexport { Fragment }\n"],"mappings":";;;AAEA,MAAa,WAAW,OAAO,IAAI,eAAe;AAClD,MAAa,iBAAiB,OAAO,IAAI,YAAY;AACrD,MAAa,cAAc,OAAO,IAAI,YAAY;AAClD,MAAa,eAAe,OAAO,IAAI,UAAU;AACjD,MAAa,iBAAiB,OAAO,IAAI,sBAAsB;;;;ACO/D,MAAaK,gBAAgBC,OAAOC,IAAI,qBAAA;AA0ExC,SAAgBC,UACdC,UAGI,EAAE,EAAA;CAEN,MAAM,EAAEC,QAAQC,WAAWX,mBAAmBS;AAE9C,SACEG,QACAC,YAAAA;AAEA,MACE,WAAYA,QAAQC,SAAS,WAC5BF,kBAAkBG,YAAY,CAACF,QAEhC,OAAM,IAAIG,MACR,0EAAA;AAKJ,MAAI,OAAOJ,OAAOK,UAAUC,WAAW,WACrC,OAAM,IAAIF,MACR,2CAA2CJ,OAAOO,KAAK,mCAAkC;EAK7F,MAAMC,kBAAkBV,SACpBN,eAAeiB,OAAOT,QAAQF,OAAAA,GAC9BN,eAAeiB,OAAOT,OAAAA;AAG1BD,WAASW,IACPF,iBACAnB,gBAAgBsB,SAChBX,QACAT,eAAeqB,MAAK;AAKtBZ,SAAOV,uBAAuBkB;AAI9BR,SAAOP,iBAAiB;AAExB,SAAOO;;;;;;;;;;;;;;;;;;;GAqBX,SAAgBa,iBAAiBC,OAAc;AAC7C,QACE,OAAOA,UAAU,cAEjBA,MAAMrB,mBAAmB;;;;;ACtJ7B,SAAS,gBAAgB,UAA6B;AACpD,KAAI,YAAY,QAAQ,aAAa,MACnC,QAAO,EAAE;AAEX,KAAI,MAAM,QAAQ,SAAS,CACzB,QAAO,SAAS,KAAK,SAAS,CAAC,QAAQ,MAAM,KAAK,QAAQ,MAAM,MAAM;AAExE,QAAO,CAAC,SAAS;;;;;;;AAQnB,SAAgB,IACd,MACA,OAC6C;CAC7C,MAAM,EAAE,UAAU,GAAG,cAAc,SAAS,EAAE;CAC9C,MAAM,eAAe,gBAAgB,SAAS;AAG9C,KAAI,iBAAiB,KAAK,CACxB,QAAO;EACL,MAAM;EACN,gBAAgB;EAChB,OAAO;GAAE,GAAG;GAAW,UAAU;GAAc;EAChD;AAIH,KAAI,OAAO,SAAS,YAAY;EAC9B,MAAM,SAAS,KAAK;GAAE,GAAG;GAAW,UAAU;GAAc,CAAC;AAG7D,MAAI,kBAAkB,QACpB,QAAO;GACL,MAAM;GACN,SAAS;GACV;AAGH,SAAO;;AAGT,QAAO;EACL;EACA,OAAO;EACP,UAAU;EACX;;;;;;AAOH,MAAa,OAAO;;;;;AAMpB,SAAgB,cACd,MACA,OACA,GAAG,UAC0C;CAC7C,MAAM,eAAe,gBAAgB,SAAS;AAG9C,KAAI,iBAAiB,KAAK,CACxB,QAAO;EACL,MAAM;EACN,gBAAgB;EAChB,OAAO;GAAE,GAAG;GAAO,UAAU;GAAc;EAC5C;AAIH,KAAI,OAAO,SAAS,YAAY;EAC9B,MAAM,SAAS,KAAK;GAAE,GAAG;GAAO,UAAU;GAAc,CAAC;AAGzD,MAAI,kBAAkB,QACpB,QAAO;GACL,MAAM;GACN,SAAS;GACV;AAGH,SAAO;;AAGT,QAAO;EACL;EACA,OAAO,SAAS,EAAE;EAClB,UAAU;EACX"}