@almadar/sdk 0.1.0 → 0.2.0

package/dist/AlmadarApp-DgwtnIRy.d.ts

@@ -0,0 +1,9 @@
+import * as react from 'react';
+import { A as AlmadarAppProps } from './types-C6RJADoY.js';
+
+declare function AlmadarApp(props: AlmadarAppProps): react.JSX.Element;
+declare namespace AlmadarApp {
+    var displayName: string;
+}
+
+export { AlmadarApp as A };

package/dist/client/index.d.ts

@@ -1,7 +1,7 @@
 import { OrbitalSchema } from '@almadar/core';
 export { EntityData, EventPayload, OrbitalSchema, SSEEvent } from '@almadar/core';
-import { a as AlmadarClientOptions, G as GenerateOptions, e as GenerateResult, E as EditSchemaPatch, C as CompileOptions, d as CompileResult, b as ApiErrorBody } from '../types-D-q0c5Yt.js';
-export { c as AsyncJobHandle } from '../types-D-q0c5Yt.js';
+import { a as AlmadarClientOptions, G as GenerateOptions, e as GenerateResult, E as EditSchemaPatch, C as CompileOptions, d as CompileResult, b as ApiErrorBody } from '../types-C6RJADoY.js';
+export { c as AsyncJobHandle } from '../types-C6RJADoY.js';
 
 /**
  * `AlmadarClient` — server / Node-side HTTP client targeting `/api/v1/agent/*`.

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-export { AlmadarApp } from './react/index.js';
+export { A as AlmadarApp } from './AlmadarApp-DgwtnIRy.js';
 export { useEventBus as useOrbBus } from '@almadar/ui/hooks';
 export { AlmadarClient, AlmadarError, ApiKeyError, CatalogOutOfScopeError, RateLimitedError, ServerError } from './client/index.js';
-export { A as AlmadarAppProps, a as AlmadarClientOptions, b as ApiErrorBody, c as AsyncJobHandle, C as CompileOptions, d as CompileResult, E as EditSchemaPatch, G as GenerateOptions, e as GenerateResult } from './types-D-q0c5Yt.js';
+export { A as AlmadarAppProps, a as AlmadarClientOptions, b as ApiErrorBody, c as AsyncJobHandle, C as CompileOptions, d as CompileResult, E as EditSchemaPatch, G as GenerateOptions, e as GenerateResult } from './types-C6RJADoY.js';
 export { EntityData, EventPayload, OrbitalSchema, SSEEvent } from '@almadar/core';
 import 'react';

package/dist/index.js

@@ -1,10 +1,93 @@
-import { lazy, Suspense } from 'react';
+import { lazy, useMemo, useState, useEffect, Suspense } from 'react';
+import { Box, Stack, Typography, PropertyInspector } from '@almadar/ui/components';
+import { jsx, jsxs } from 'react/jsx-runtime';
 import '@almadar/ui/index.css';
-import { jsx } from 'react/jsx-runtime';
 export { useEventBus as useOrbBus } from '@almadar/ui/hooks';
 import { parseOrbitalSchema } from '@almadar/core';
 
 // src/react/AlmadarApp.tsx
+function parseSchema(schema) {
+  if (typeof schema === "string") {
+    return JSON.parse(schema);
+  }
+  return schema;
+}
+function deepClone(value) {
+  return JSON.parse(JSON.stringify(value));
+}
+function findConfigTrait(schema) {
+  if (!schema?.orbitals) return null;
+  for (const orbital of schema.orbitals) {
+    for (const traitRef of orbital.traits ?? []) {
+      if (typeof traitRef !== "object" || traitRef === null) continue;
+      const trait = traitRef;
+      if (trait.config && Object.keys(trait.config).length > 0) {
+        const name = "name" in trait && typeof trait.name === "string" ? trait.name : "Config";
+        return { name, config: trait.config };
+      }
+    }
+  }
+  return null;
+}
+function applyConfigOverride(schema, field, value) {
+  const next = deepClone(schema);
+  for (const orbital of next.orbitals ?? []) {
+    for (const traitRef of orbital.traits ?? []) {
+      if (typeof traitRef !== "object" || traitRef === null) continue;
+      const trait = traitRef;
+      if (trait.config && field in trait.config) {
+        trait.config[field] = { ...trait.config[field], default: value };
+        return next;
+      }
+    }
+  }
+  return next;
+}
+function OrbitalConfigPanel({
+  schema,
+  exposedTiers,
+  position = "right",
+  onSchemaChange
+}) {
+  const parsed = useMemo(() => parseSchema(schema), [schema]);
+  const target = useMemo(() => findConfigTrait(parsed), [parsed]);
+  const [values, setValues] = useState({});
+  if (!target) return null;
+  const sortedConfig = Object.fromEntries(
+    Object.entries(target.config).sort(([a], [b]) => a.localeCompare(b))
+  );
+  const handleChange = (field, value) => {
+    setValues((prev) => ({ ...prev, [field]: value }));
+    const nextSchema = applyConfigOverride(parsed, field, value);
+    onSchemaChange?.(nextSchema);
+  };
+  const handleReset = () => {
+    setValues({});
+    onSchemaChange?.(parsed);
+  };
+  const isHorizontal = position === "bottom";
+  return /* @__PURE__ */ jsx(
+    Box,
+    {
+      className: `${isHorizontal ? "w-full border-t" : "h-full w-80 flex-shrink-0 border-l"} border-border bg-card p-3 overflow-y-auto`,
+      children: /* @__PURE__ */ jsxs(Stack, { direction: "vertical", gap: "sm", children: [
+        /* @__PURE__ */ jsx(Typography, { variant: "caption", weight: "bold", color: "muted", children: "Controls" }),
+        /* @__PURE__ */ jsx(
+          PropertyInspector,
+          {
+            title: target.name,
+            config: sortedConfig,
+            values,
+            onChange: handleChange,
+            onReset: handleReset,
+            tiers: exposedTiers
+          }
+        )
+      ] })
+    }
+  );
+}
+OrbitalConfigPanel.displayName = "OrbitalConfigPanel";
 var OrbPreviewLazy = lazy(async () => {
   const mod = await import('@almadar/ui/runtime');
   return { default: mod.OrbPreview };
@@ -13,12 +96,25 @@ var BrowserPlaygroundLazy = lazy(async () => {
   const mod = await import('@almadar/ui/runtime');
   return { default: mod.BrowserPlayground };
 });
+function parseSchema2(schema) {
+  if (typeof schema === "string") {
+    return JSON.parse(schema);
+  }
+  return schema;
+}
 function AlmadarApp(props) {
   const mode = props.mode ?? "static";
-  return /* @__PURE__ */ jsx(Suspense, { fallback: null, children: mode === "mock" ? /* @__PURE__ */ jsx(
+  const parsedSchema = useMemo(() => parseSchema2(props.schema), [props.schema]);
+  const [controlledSchema, setControlledSchema] = useState(parsedSchema);
+  useEffect(() => {
+    setControlledSchema(parsedSchema);
+  }, [parsedSchema]);
+  const effectiveSchema = props.exposedTiers && mode !== "server" ? controlledSchema : parsedSchema;
+  const showControls = props.exposedTiers && props.exposedTiers.length > 0 && mode !== "server";
+  const preview = mode === "mock" ? /* @__PURE__ */ jsx(
     BrowserPlaygroundLazy,
     {
-      schema: props.schema,
+      schema: effectiveSchema,
       mode: "mock",
       initialPagePath: props.initialPagePath,
       height: props.height,
@@ -27,13 +123,36 @@ function AlmadarApp(props) {
   ) : /* @__PURE__ */ jsx(
     OrbPreviewLazy,
     {
-      schema: props.schema,
+      schema: effectiveSchema,
       mockData: props.data,
       serverUrl: props.serverUrl,
       initialPagePath: props.initialPagePath,
       height: props.height,
       className: props.className
     }
+  );
+  if (!showControls) {
+    return /* @__PURE__ */ jsx(Suspense, { fallback: null, children: preview });
+  }
+  const isBottom = props.controlsPosition === "bottom";
+  return /* @__PURE__ */ jsx(Suspense, { fallback: null, children: /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: `flex ${isBottom ? "flex-col" : "flex-row"} w-full h-full`,
+      style: { height: props.height },
+      children: [
+        /* @__PURE__ */ jsx("div", { className: "flex-1 min-w-0", children: preview }),
+        /* @__PURE__ */ jsx(
+          OrbitalConfigPanel,
+          {
+            schema: parsedSchema,
+            exposedTiers: props.exposedTiers,
+            position: props.controlsPosition,
+            onSchemaChange: setControlledSchema
+          }
+        )
+      ]
+    }
   ) });
 }
 AlmadarApp.displayName = "AlmadarApp";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/react/AlmadarApp.tsx","../src/client/errors.ts","../src/client/sseParser.ts","../src/client/AlmadarClient.ts"],"names":[],"mappings":";;;;;;;AAuBA,IAAM,cAAA,GAAiB,KAAK,YAAY;AACtC,EAAA,MAAM,GAAA,GAAM,MAAM,OAAO,qBAAqB,CAAA;AAC9C,EAAA,OAAO,EAAE,OAAA,EAAS,GAAA,CAAI,UAAA,EAAW;AACnC,CAAC,CAAA;AAED,IAAM,qBAAA,GAAwB,KAAK,YAAY;AAC7C,EAAA,MAAM,GAAA,GAAM,MAAM,OAAO,qBAAqB,CAAA;AAC9C,EAAA,OAAO,EAAE,OAAA,EAAS,GAAA,CAAI,iBAAA,EAAkB;AAC1C,CAAC,CAAA;AAEM,SAAS,WAAW,KAAA,EAAwB;AACjD,EAAA,MAAM,IAAA,GAAO,MAAM,IAAA,IAAQ,QAAA;AAE3B,EAAA,uBACE,GAAA,CAAC,QAAA,EAAA,EAAS,QAAA,EAAU,IAAA,EACjB,mBAAS,MAAA,mBACR,GAAA;AAAA,IAAC,qBAAA;AAAA,IAAA;AAAA,MACC,QAAQ,KAAA,CAAM,MAAA;AAAA,MACd,IAAA,EAAK,MAAA;AAAA,MACL,iBAAiB,KAAA,CAAM,eAAA;AAAA,MACvB,QAAQ,KAAA,CAAM,MAAA;AAAA,MACd,WAAW,KAAA,CAAM;AAAA;AAAA,GACnB,mBAEA,GAAA;AAAA,IAAC,cAAA;AAAA,IAAA;AAAA,MACC,QAAQ,KAAA,CAAM,MAAA;AAAA,MACd,UAAU,KAAA,CAAM,IAAA;AAAA,MAChB,WAAW,KAAA,CAAM,SAAA;AAAA,MACjB,iBAAiB,KAAA,CAAM,eAAA;AAAA,MACvB,QAAQ,KAAA,CAAM,MAAA;AAAA,MACd,WAAW,KAAA,CAAM;AAAA;AAAA,GACnB,EAEJ,CAAA;AAEJ;AAEA,UAAA,CAAW,WAAA,GAAc,YAAA;;;ACrDlB,IAAM,YAAA,GAAN,cAA2B,KAAA,CAAM;AAAA,EAC7B,IAAA;AAAA,EACA,OAAA;AAAA,EACT,YAAY,IAAA,EAAoB;AAC9B,IAAA,KAAA,CAAM,KAAK,OAAO,CAAA;AAClB,IAAA,IAAA,CAAK,IAAA,GAAO,cAAA;AACZ,IAAA,IAAA,CAAK,OAAO,IAAA,CAAK,IAAA;AACjB,IAAA,IAAA,CAAK,UAAU,IAAA,CAAK,OAAA;AAAA,EACtB;AACF;AAGO,IAAM,WAAA,GAAN,cAA0B,YAAA,CAAa;AAAA,EAC5C,YAAY,IAAA,EAAoB;AAC9B,IAAA,KAAA,CAAM,IAAI,CAAA;AACV,IAAA,IAAA,CAAK,IAAA,GAAO,aAAA;AAAA,EACd;AACF;AAGO,IAAM,gBAAA,GAAN,cAA+B,YAAA,CAAa;AAAA,EACxC,iBAAA;AAAA,EACT,WAAA,CAAY,MAAoB,iBAAA,EAA4B;AAC1D,IAAA,KAAA,CAAM,IAAI,CAAA;AACV,IAAA,IAAA,CAAK,IAAA,GAAO,kBAAA;AACZ,IAAA,IAAA,CAAK,iBAAA,GAAoB,iBAAA;AAAA,EAC3B;AACF;AAGO,IAAM,sBAAA,GAAN,cAAqC,YAAA,CAAa;AAAA,EACvD,YAAY,IAAA,EAAoB;AAC9B,IAAA,KAAA,CAAM,IAAI,CAAA;AACV,IAAA,IAAA,CAAK,IAAA,GAAO,wBAAA;AAAA,EACd;AACF;AAGO,IAAM,WAAA,GAAN,cAA0B,YAAA,CAAa;AAAA,EAC5C,YAAY,IAAA,EAAoB;AAC9B,IAAA,KAAA,CAAM,IAAI,CAAA;AACV,IAAA,IAAA,CAAK,IAAA,GAAO,aAAA;AAAA,EACd;AACF;AAEO,SAAS,cAAc,IAAA,EAAkC;AAC9D,EAAA,QAAQ,KAAK,IAAA;AAAM,IACjB,KAAK,IAAA;AACH,MAAA,OAAO,IAAI,YAAY,IAAI,CAAA;AAAA,IAC7B,KAAK,IAAA;AACH,MAAA,OAAO,IAAI,iBAAiB,IAAI,CAAA;AAAA,IAClC,KAAK,IAAA;AACH,MAAA,OAAO,IAAI,uBAAuB,IAAI,CAAA;AAAA,IACxC;AACE,MAAA,OAAO,IAAI,YAAY,IAAI,CAAA;AAAA;AAEjC;;;ACxCA,gBAAuB,SACrB,MAAA,EACyC;AACzC,EAAA,MAAM,MAAA,GAAS,OAAO,SAAA,EAAU;AAChC,EAAA,MAAM,OAAA,GAAU,IAAI,WAAA,CAAY,OAAO,CAAA;AACvC,EAAA,IAAI,MAAA,GAAS,EAAA;AACb,EAAA,IAAI,YAAA,GAAe,EAAA;AACnB,EAAA,IAAI,WAAA,GAAc,EAAA;AAElB,EAAA,IAAI;AACF,IAAA,WAAS;AACP,MAAA,MAAM,EAAE,KAAA,EAAO,IAAA,EAAK,GAAI,MAAM,OAAO,IAAA,EAAK;AAC1C,MAAA,IAAI,IAAA,EAAM;AACV,MAAA,MAAA,IAAU,QAAQ,MAAA,CAAO,KAAA,EAAO,EAAE,MAAA,EAAQ,MAAM,CAAA;AAEhD,MAAA,IAAI,UAAA;AACJ,MAAA,OAAA,CAAQ,UAAA,GAAa,cAAA,CAAe,MAAM,CAAA,MAAO,CAAA,CAAA,EAAI;AACnD,QAAA,MAAM,OAAA,GAAU,MAAA,CAAO,KAAA,CAAM,CAAA,EAAG,UAAU,CAAA;AAC1C,QAAA,MAAA,GAAS,MAAA,CAAO,KAAA,CAAM,UAAA,IAAc,MAAA,CAAO,UAAU,CAAA,KAAM,IAAA,IAAQ,MAAA,CAAO,UAAA,GAAa,CAAC,CAAA,KAAM,IAAA,GAAO,IAAI,CAAA,CAAE,CAAA;AAE3G,QAAA,IAAI,YAAY,EAAA,EAAI;AAClB,UAAA,IAAI,WAAA,KAAgB,EAAA,IAAM,YAAA,KAAiB,EAAA,EAAI;AAC7C,YAAA,MAAM,EAAE,KAAA,EAAO,YAAA,EAAc,IAAA,EAAM,WAAA,EAAY;AAC/C,YAAA,YAAA,GAAe,EAAA;AACf,YAAA,WAAA,GAAc,EAAA;AAAA,UAChB;AACA,UAAA;AAAA,QACF;AACA,QAAA,IAAI,OAAA,CAAQ,UAAA,CAAW,GAAG,CAAA,EAAG;AAE7B,QAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,OAAA,CAAQ,GAAG,CAAA;AACjC,QAAA,MAAM,QAAQ,KAAA,KAAU,CAAA,CAAA,GAAK,UAAU,OAAA,CAAQ,KAAA,CAAM,GAAG,KAAK,CAAA;AAC7D,QAAA,MAAM,WAAW,KAAA,KAAU,CAAA,CAAA,GAAK,KAAK,OAAA,CAAQ,KAAA,CAAM,QAAQ,CAAC,CAAA;AAC5D,QAAA,MAAM,MAAA,GAAS,SAAS,UAAA,CAAW,GAAG,IAAI,QAAA,CAAS,KAAA,CAAM,CAAC,CAAA,GAAI,QAAA;AAE9D,QAAA,IAAI,UAAU,OAAA,EAAS;AACrB,UAAA,YAAA,GAAe,MAAA;AAAA,QACjB,CAAA,MAAA,IAAW,UAAU,MAAA,EAAQ;AAC3B,UAAA,WAAA,GAAc,WAAA,KAAgB,EAAA,GAAK,MAAA,GAAS,CAAA,EAAG,WAAW;AAAA,EAAK,MAAM,CAAA,CAAA;AAAA,QACvE;AAAA,MACF;AAAA,IACF;AACA,IAAA,IAAI,WAAA,KAAgB,EAAA,IAAM,YAAA,KAAiB,EAAA,EAAI;AAC7C,MAAA,MAAM,EAAE,KAAA,EAAO,YAAA,EAAc,IAAA,EAAM,WAAA,EAAY;AAAA,IACjD;AAAA,EACF,CAAA,SAAE;AACA,IAAA,MAAA,CAAO,WAAA,EAAY;AAAA,EACrB;AACF;AAEA,SAAS,eAAe,CAAA,EAAmB;AACzC,EAAA,KAAA,IAAS,IAAI,CAAA,EAAG,CAAA,GAAI,CAAA,CAAE,MAAA,EAAQ,KAAK,CAAA,EAAG;AACpC,IAAA,MAAM,CAAA,GAAI,EAAE,CAAC,CAAA;AACb,IAAA,IAAI,CAAA,KAAM,IAAA,IAAQ,CAAA,KAAM,IAAA,EAAM,OAAO,CAAA;AAAA,EACvC;AACA,EAAA,OAAO,EAAA;AACT;;;ACxDA,IAAM,gBAAA,GAAmB,2BAAA;AACzB,IAAM,kBAAqC,CAAC,GAAA,EAAM,GAAA,EAAM,GAAA,EAAM,KAAQ,GAAM,CAAA;AAUrE,IAAM,gBAAN,MAAoB;AAAA,EACR,MAAA;AAAA,EACA,OAAA;AAAA,EACA,SAAA;AAAA,EAEjB,YAAY,IAAA,EAA4B;AACtC,IAAA,IAAI,CAAC,IAAA,CAAK,MAAA,IAAU,OAAO,IAAA,CAAK,WAAW,QAAA,EAAU;AACnD,MAAA,MAAM,IAAI,MAAM,wCAAwC,CAAA;AAAA,IAC1D;AACA,IAAA,IAAA,CAAK,SAAS,IAAA,CAAK,MAAA;AACnB,IAAA,IAAA,CAAK,WAAW,IAAA,CAAK,OAAA,IAAW,gBAAA,EAAkB,OAAA,CAAQ,OAAO,EAAE,CAAA;AACnE,IAAA,IAAA,CAAK,SAAA,GAAY,IAAA,CAAK,KAAA,IAAS,UAAA,CAAW,KAAA;AAC1C,IAAA,IAAI,OAAO,IAAA,CAAK,SAAA,KAAc,UAAA,EAAY;AACxC,MAAA,MAAM,IAAI,MAAM,uEAAkE,CAAA;AAAA,IACpF;AAAA,EACF;AAAA,EAEA,MAAM,SAAS,KAAA,EAAiD;AAC9D,IAAA,IAAI,KAAA,CAAM,UAAU,IAAA,EAAM;AACxB,MAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,WAAA,CAA4B,QAAQ,wBAAA,EAA0B;AAAA,QACtF,QAAQ,KAAA,CAAM,MAAA;AAAA,QACd,WAAW,KAAA,CAAM,SAAA;AAAA,QACjB,OAAO,KAAA,CAAM,KAAA;AAAA,QACb,KAAA,EAAO,IAAA;AAAA,QACP,UAAU,KAAA,CAAM,QAAA;AAAA,QAChB,OAAO,KAAA,CAAM,KAAA;AAAA,QACb,aAAa,KAAA,CAAM,WAAA;AAAA,QACnB,cAAc,KAAA,CAAM;AAAA,OACrB,CAAA;AACD,MAAA,YAAA,CAAa,MAAA,CAAO,OAAO,sBAAsB,CAAA;AACjD,MAAA,YAAA,CAAa,MAAA,CAAO,WAAW,0BAA0B,CAAA;AACzD,MAAA,OAAO,IAAA,CAAK,iBAAA,CAAkB,MAAA,EAAQ,KAAA,CAAM,OAAO,CAAA;AAAA,IACrD;AACA,IAAA,OAAO,IAAA,CAAK,eAAe,KAAK,CAAA;AAAA,EAClC;AAAA,EAEA,MAAM,UAAA,CAAW,KAAA,EAAe,KAAA,EAAgD;AAC9E,IAAA,IAAI,CAAC,KAAA,EAAO,MAAM,IAAI,MAAM,6CAA6C,CAAA;AACzE,IAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,WAAA,CAA2B,OAAO,2BAAA,EAA6B;AAAA,MACvF,KAAA;AAAA,MACA;AAAA,KACD,CAAA;AACD,IAAA,YAAA,CAAa,MAAA,CAAO,MAAM,oBAAoB,CAAA;AAC9C,IAAA,OAAO,MAAA;AAAA,EACT;AAAA,EAEA,MAAM,YAAA,CAAa,MAAA,EAAuB,IAAA,EAA+C;AACvF,IAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,WAAA,CAA2B,QAAQ,uBAAA,EAAyB;AAAA,MACpF,MAAA;AAAA,MACA,QAAQ,IAAA,EAAM,MAAA;AAAA,MACd,OAAO,IAAA,EAAM;AAAA,KACd,CAAA;AACD,IAAA,YAAA,CAAa,MAAA,CAAO,aAAa,2BAA2B,CAAA;AAC5D,IAAA,YAAA,CAAa,MAAA,CAAO,WAAW,yBAAyB,CAAA;AACxD,IAAA,OAAO,MAAA;AAAA,EACT;AAAA,EAEA,MAAc,eAAe,KAAA,EAAiD;AAC5E,IAAA,MAAM,MAAM,MAAM,IAAA,CAAK,UAAU,CAAA,EAAG,IAAA,CAAK,OAAO,CAAA,sBAAA,CAAA,EAA0B;AAAA,MACxE,MAAA,EAAQ,MAAA;AAAA,MACR,OAAA,EAAS,IAAA,CAAK,OAAA,CAAQ,EAAE,MAAA,EAAQ,qBAAqB,WAAA,EAAa,kBAAA,EAAmB,EAAG,KAAA,CAAM,SAAS,CAAA;AAAA,MACvG,IAAA,EAAM,KAAK,SAAA,CAAU;AAAA,QACnB,QAAQ,KAAA,CAAM,MAAA;AAAA,QACd,WAAW,KAAA,CAAM,SAAA;AAAA,QACjB,OAAO,KAAA,CAAM,KAAA;AAAA,QACb,UAAU,KAAA,CAAM,QAAA;AAAA,QAChB,OAAO,KAAA,CAAM,KAAA;AAAA,QACb,aAAa,KAAA,CAAM,WAAA;AAAA,QACnB,cAAc,KAAA,CAAM;AAAA,OACrB;AAAA,KACF,CAAA;AACD,IAAA,IAAI,CAAC,GAAA,CAAI,EAAA,QAAU,MAAM,IAAA,CAAK,kBAAkB,GAAG,CAAA;AACnD,IAAA,IAAI,IAAI,IAAA,KAAS,IAAA,EAAM,MAAM,IAAI,MAAM,iDAAiD,CAAA;AAExF,IAAA,IAAI,KAAA,GAA+B,IAAA;AACnC,IAAA,WAAA,MAAiB,GAAA,IAAO,QAAA,CAAS,GAAA,CAAI,IAAI,CAAA,EAAG;AAC1C,MAAA,MAAM,KAAA,GAAQ,aAAA,CAAc,GAAA,CAAI,IAAI,CAAA;AACpC,MAAA,IAAI,UAAU,IAAA,EAAM;AACpB,MAAA,KAAA,CAAM,UAAU,KAAK,CAAA;AACrB,MAAA,IAAI,KAAA,CAAM,SAAS,UAAA,EAAY;AAC7B,QAAA,IAAI,KAAA,CAAM,IAAA,CAAK,MAAA,KAAW,MAAA,EAAW;AACnC,UAAA,MAAM,IAAI,WAAA,CAAY,EAAE,MAAM,GAAA,EAAK,OAAA,EAAS,6CAA6C,CAAA;AAAA,QAC3F;AACA,QAAA,MAAM,MAAA,GAAS,kBAAA,CAAmB,KAAA,CAAM,IAAA,CAAK,MAAM,CAAA;AACnD,QAAA,KAAA,GAAQ,EAAE,MAAA,EAAQ,KAAA,EAAO,KAAA,CAAM,KAAK,KAAA,EAAM;AAAA,MAC5C,CAAA,MAAA,IAAW,KAAA,CAAM,IAAA,KAAS,OAAA,EAAS;AACjC,QAAA,MAAM,aAAA,CAAc,EAAE,IAAA,EAAM,GAAA,EAAK,SAAS,KAAA,CAAM,IAAA,CAAK,OAAO,CAAA;AAAA,MAC9D;AAAA,IACF;AACA,IAAA,IAAI,UAAU,IAAA,EAAM;AAClB,MAAA,MAAM,IAAI,WAAA,CAAY,EAAE,MAAM,GAAA,EAAK,OAAA,EAAS,6CAA6C,CAAA;AAAA,IAC3F;AACA,IAAA,OAAO,KAAA;AAAA,EACT;AAAA,EAEA,MAAc,iBAAA,CACZ,MAAA,EACA,OAAA,EACyB;AACzB,IAAA,IAAI,OAAA,GAAU,CAAA;AACd,IAAA,WAAS;AACP,MAAA,MAAM,KAAA,GAAQ,gBAAgB,IAAA,CAAK,GAAA,CAAI,SAAS,eAAA,CAAgB,MAAA,GAAS,CAAC,CAAC,CAAA;AAC3E,MAAA,MAAM,MAAM,KAAK,CAAA;AACjB,MAAA,OAAA,IAAW,CAAA;AACX,MAAA,MAAM,SAAS,MAAM,IAAA,CAAK,WAAA,CAAuB,KAAA,EAAO,OAAO,SAAS,CAAA;AACxE,MAAA,YAAA,CAAa,MAAA,CAAO,OAAO,iBAAiB,CAAA;AAC5C,MAAA,IAAI,MAAA,CAAO,MAAA,KAAW,MAAA,IAAa,OAAA,KAAY,MAAA,EAAW;AACxD,QAAA,KAAA,MAAW,CAAA,IAAK,MAAA,CAAO,MAAA,EAAQ,OAAA,CAAQ,CAAC,CAAA;AAAA,MAC1C;AACA,MAAA,IAAI,MAAA,CAAO,UAAU,UAAA,EAAY;AAC/B,QAAA,IAAI,MAAA,CAAO,WAAW,MAAA,EAAW;AAC/B,UAAA,MAAM,IAAI,WAAA,CAAY,EAAE,MAAM,GAAA,EAAK,OAAA,EAAS,uCAAuC,CAAA;AAAA,QACrF;AACA,QAAA,OAAO,MAAA,CAAO,MAAA;AAAA,MAChB;AACA,MAAA,IAAI,MAAA,CAAO,UAAU,OAAA,EAAS;AAC5B,QAAA,MAAM,aAAA,CAAc;AAAA,UAClB,IAAA,EAAM,OAAO,SAAA,IAAa,GAAA;AAAA,UAC1B,OAAA,EAAS,OAAO,YAAA,IAAgB;AAAA,SACjC,CAAA;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAc,WAAA,CAAe,MAAA,EAAgB,IAAA,EAAc,IAAA,EAA2B;AACpF,IAAA,MAAM,aAAa,IAAA,CAAK,UAAA,CAAW,SAAS,CAAA,IAAK,IAAA,CAAK,WAAW,UAAU,CAAA;AAC3E,IAAA,MAAM,MAAM,UAAA,GAAa,IAAA,GAAO,GAAG,IAAA,CAAK,OAAO,GAAG,IAAI,CAAA,CAAA;AACtD,IAAA,MAAM,IAAA,GAAoB;AAAA,MACxB,MAAA;AAAA,MACA,OAAA,EAAS,KAAK,OAAA,CAAQ;AAAA,QACpB,MAAA,EAAQ,kBAAA;AAAA,QACR,WAAA,EAAa,IAAA,KAAS,MAAA,GAAY,kBAAA,GAAqB;AAAA,OACxD;AAAA,KACH;AACA,IAAA,IAAI,SAAS,MAAA,EAAW,IAAA,CAAK,IAAA,GAAO,IAAA,CAAK,UAAU,IAAI,CAAA;AACvD,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,SAAA,CAAU,KAAK,IAAI,CAAA;AAC1C,IAAA,IAAI,CAAC,GAAA,CAAI,EAAA,QAAU,MAAM,IAAA,CAAK,kBAAkB,GAAG,CAAA;AACnD,IAAA,MAAM,IAAA,GAAO,MAAM,GAAA,CAAI,IAAA,EAAK;AAC5B,IAAA,IAAI,SAAS,EAAA,EAAI;AACf,MAAA,MAAM,IAAI,WAAA,CAAY,EAAE,MAAM,GAAA,EAAK,OAAA,EAAS,uBAAuB,CAAA;AAAA,IACrE;AACA,IAAA,MAAM,MAAA,GAAY,IAAA,CAAK,KAAA,CAAM,IAAI,CAAA;AACjC,IAAA,OAAO,MAAA;AAAA,EACT;AAAA,EAEQ,OAAA,CACN,MACA,SAAA,EACwB;AACxB,IAAA,MAAM,IAA4B,EAAE,aAAA,EAAe,CAAA,OAAA,EAAU,IAAA,CAAK,MAAM,CAAA,CAAA,EAAG;AAC3E,IAAA,IAAI,KAAK,MAAA,KAAW,MAAA,EAAW,CAAA,CAAE,QAAQ,IAAI,IAAA,CAAK,MAAA;AAClD,IAAA,IAAI,KAAK,WAAA,KAAgB,MAAA,EAAW,CAAA,CAAE,cAAc,IAAI,IAAA,CAAK,WAAA;AAC7D,IAAA,IAAI,cAAc,MAAA,IAAa,SAAA,KAAc,EAAA,EAAI,CAAA,CAAE,eAAe,CAAA,GAAI,SAAA;AACtE,IAAA,OAAO,CAAA;AAAA,EACT;AAAA,EAEA,MAAc,kBAAkB,GAAA,EAA+B;AAC7D,IAAA,MAAM,IAAA,GAAO,MAAM,GAAA,CAAI,IAAA,EAAK;AAC5B,IAAA,IAAI,IAAA;AACJ,IAAA,IAAI;AACF,MAAA,MAAM,SAA8B,IAAA,KAAS,EAAA,GAAK,IAAA,GAAO,IAAA,CAAK,MAAM,IAAI,CAAA;AACxE,MAAA,IAAA,GAAO,MAAA,KAAW,IAAA,IAAQ,OAAO,MAAA,CAAO,IAAA,KAAS,YAAY,OAAO,MAAA,CAAO,OAAA,KAAY,QAAA,GACnF,MAAA,GACA;AAAA,QACE,MAAM,GAAA,CAAI,MAAA;AAAA,QACV,OAAA,EAAS,GAAA,CAAI,UAAA,KAAe,EAAA,GAAK,IAAI,UAAA,GAAa;AAAA,OACpD;AAAA,IACN,CAAA,CAAA,MAAQ;AACN,MAAA,IAAA,GAAO,EAAE,MAAM,GAAA,CAAI,MAAA,EAAQ,SAAS,IAAA,KAAS,EAAA,GAAK,IAAA,GAAO,GAAA,CAAI,UAAA,EAAW;AAAA,IAC1E;AACA,IAAA,MAAM,UAAA,GAAa,GAAA,CAAI,OAAA,CAAQ,GAAA,CAAI,aAAa,CAAA;AAChD,IAAA,MAAM,GAAA,GAAM,cAAc,IAAI,CAAA;AAC9B,IAAA,IAAI,GAAA,CAAI,IAAA,KAAS,kBAAA,IAAsB,UAAA,KAAe,IAAA,EAAM;AAC1D,MAAA,MAAM,OAAA,GAAU,OAAO,UAAU,CAAA;AACjC,MAAA,IAAI,MAAA,CAAO,QAAA,CAAS,OAAO,CAAA,EAAG;AAC5B,QAAA,MAAA,CAAO,cAAA,CAAe,KAAK,mBAAA,EAAqB,EAAE,OAAO,OAAA,EAAS,UAAA,EAAY,MAAM,CAAA;AAAA,MACtF;AAAA,IACF;AACA,IAAA,OAAO,GAAA;AAAA,EACT;AACF;AAQA,SAAS,cAAc,QAAA,EAAmC;AACxD,EAAA,IAAI,QAAA,KAAa,IAAI,OAAO,IAAA;AAC5B,EAAA,IAAI,OAAA;AACJ,EAAA,IAAI;AACF,IAAA,OAAA,GAAU,IAAA,CAAK,MAAM,QAAQ,CAAA;AAAA,EAC/B,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,IAAI,OAAA,KAAY,QAAQ,OAAO,OAAA,KAAY,YAAY,KAAA,CAAM,OAAA,CAAQ,OAAO,CAAA,EAAG,OAAO,IAAA;AACtF,EAAA,IAAI,OAAO,QAAQ,IAAA,KAAS,QAAA,IAAY,OAAO,OAAA,CAAQ,SAAA,KAAc,UAAU,OAAO,IAAA;AACtF,EAAA,OAAO,OAAA;AACT;AAEA,SAAS,YAAA,CAAa,GAAuB,IAAA,EAAmC;AAC9E,EAAA,IAAI,OAAO,CAAA,KAAM,QAAA,IAAY,CAAA,KAAM,EAAA,EAAI;AACrC,IAAA,MAAM,IAAI,YAAY,EAAE,IAAA,EAAM,KAAK,OAAA,EAAS,CAAA,2BAAA,EAA8B,IAAI,CAAA,gBAAA,CAAA,EAAoB,CAAA;AAAA,EACpG;AACF;AAEA,SAAS,MAAM,EAAA,EAA2B;AACxC,EAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,YAAY,UAAA,CAAW,OAAA,EAAS,EAAE,CAAC,CAAA;AACzD","file":"index.js","sourcesContent":["'use client';\n\n/**\n * `<AlmadarApp />` — renders an orbital schema in the customer's React tree.\n *\n * Thin facade over `@almadar/ui`'s `OrbPreview` (server-backed) and\n * `BrowserPlayground` (in-browser mock server). The `mode` prop picks the\n * runtime path:\n *   - `static`: pure OrbPreview with `mockData`\n *   - `mock`  : BrowserPlayground (in-browser server, faker-seeded)\n *   - `server`: OrbPreview with `serverUrl`\n *\n * Lazy-imports the heavy runtime bundle so the SDK is import-cheap in Next.js\n * server components; the actual render happens client-side under a Suspense\n * boundary. CSS is imported as a side-effect at module load.\n */\n\nimport { lazy, Suspense } from 'react';\nimport type { AlmadarAppProps } from '../types';\n// Required global styles. Customers who self-manage Tailwind can import from\n// the (forthcoming) `@almadar/sdk/react/no-css` entry instead.\nimport '@almadar/ui/index.css';\n\nconst OrbPreviewLazy = lazy(async () => {\n  const mod = await import('@almadar/ui/runtime');\n  return { default: mod.OrbPreview };\n});\n\nconst BrowserPlaygroundLazy = lazy(async () => {\n  const mod = await import('@almadar/ui/runtime');\n  return { default: mod.BrowserPlayground };\n});\n\nexport function AlmadarApp(props: AlmadarAppProps) {\n  const mode = props.mode ?? 'static';\n\n  return (\n    <Suspense fallback={null}>\n      {mode === 'mock' ? (\n        <BrowserPlaygroundLazy\n          schema={props.schema}\n          mode=\"mock\"\n          initialPagePath={props.initialPagePath}\n          height={props.height}\n          className={props.className}\n        />\n      ) : (\n        <OrbPreviewLazy\n          schema={props.schema}\n          mockData={props.data}\n          serverUrl={props.serverUrl}\n          initialPagePath={props.initialPagePath}\n          height={props.height}\n          className={props.className}\n        />\n      )}\n    </Suspense>\n  );\n}\n\nAlmadarApp.displayName = 'AlmadarApp';\n","/**\n * Typed SDK errors. Server emits a structured `ApiErrorBody`; the HTTP layer\n * maps the `code` to one of these subclasses. Customers `catch` by class.\n */\n\nimport type { ApiErrorBody } from '../types';\n\nexport class AlmadarError extends Error {\n  readonly code: number;\n  readonly details?: ApiErrorBody['details'];\n  constructor(body: ApiErrorBody) {\n    super(body.message);\n    this.name = 'AlmadarError';\n    this.code = body.code;\n    this.details = body.details;\n  }\n}\n\n/** 4001 — invalid, revoked, or missing API key. */\nexport class ApiKeyError extends AlmadarError {\n  constructor(body: ApiErrorBody) {\n    super(body);\n    this.name = 'ApiKeyError';\n  }\n}\n\n/** 4029 — team cap (feature counter) exceeded. Retry after a billing cycle. */\nexport class RateLimitedError extends AlmadarError {\n  readonly retryAfterSeconds?: number;\n  constructor(body: ApiErrorBody, retryAfterSeconds?: number) {\n    super(body);\n    this.name = 'RateLimitedError';\n    this.retryAfterSeconds = retryAfterSeconds;\n  }\n}\n\n/** 4040 — the team's behavior catalog (subset/replace mode) cannot serve the request. */\nexport class CatalogOutOfScopeError extends AlmadarError {\n  constructor(body: ApiErrorBody) {\n    super(body);\n    this.name = 'CatalogOutOfScopeError';\n  }\n}\n\n/** Anything else from the server with a recognized envelope but no specific subclass. */\nexport class ServerError extends AlmadarError {\n  constructor(body: ApiErrorBody) {\n    super(body);\n    this.name = 'ServerError';\n  }\n}\n\nexport function errorFromBody(body: ApiErrorBody): AlmadarError {\n  switch (body.code) {\n    case 4001:\n      return new ApiKeyError(body);\n    case 4029:\n      return new RateLimitedError(body);\n    case 4040:\n      return new CatalogOutOfScopeError(body);\n    default:\n      return new ServerError(body);\n  }\n}\n","/**\n * Minimal Server-Sent Events parser. Reads a `ReadableStream<Uint8Array>`\n * (the body of a `fetch` Response) and yields decoded events. Universal:\n * works in browser, Node 18+, Deno, Bun.\n *\n * Spec subset implemented:\n *   - `event:` and `data:` fields\n *   - dispatch on blank line\n *   - newline-tolerant (CRLF + LF)\n *   - skips comments (`:`-prefixed lines)\n *\n * Not implemented (we don't need them):\n *   - `id:` / `retry:` fields\n *   - reconnection / last-event-id\n */\n\nexport interface RawSseEvent {\n  /** `event:` field value. Empty string when absent — matches the spec default. */\n  event: string;\n  /** Concatenated `data:` lines, joined by newlines. */\n  data: string;\n}\n\nexport async function* parseSSE(\n  stream: ReadableStream<Uint8Array>,\n): AsyncGenerator<RawSseEvent, void, void> {\n  const reader = stream.getReader();\n  const decoder = new TextDecoder('utf-8');\n  let buffer = '';\n  let currentEvent = '';\n  let currentData = '';\n\n  try {\n    for (;;) {\n      const { value, done } = await reader.read();\n      if (done) break;\n      buffer += decoder.decode(value, { stream: true });\n\n      let newlineIdx: number;\n      while ((newlineIdx = indexOfNewline(buffer)) !== -1) {\n        const rawLine = buffer.slice(0, newlineIdx);\n        buffer = buffer.slice(newlineIdx + (buffer[newlineIdx] === '\\r' && buffer[newlineIdx + 1] === '\\n' ? 2 : 1));\n\n        if (rawLine === '') {\n          if (currentData !== '' || currentEvent !== '') {\n            yield { event: currentEvent, data: currentData };\n            currentEvent = '';\n            currentData = '';\n          }\n          continue;\n        }\n        if (rawLine.startsWith(':')) continue;\n\n        const colon = rawLine.indexOf(':');\n        const field = colon === -1 ? rawLine : rawLine.slice(0, colon);\n        const rawValue = colon === -1 ? '' : rawLine.slice(colon + 1);\n        const value2 = rawValue.startsWith(' ') ? rawValue.slice(1) : rawValue;\n\n        if (field === 'event') {\n          currentEvent = value2;\n        } else if (field === 'data') {\n          currentData = currentData === '' ? value2 : `${currentData}\\n${value2}`;\n        }\n      }\n    }\n    if (currentData !== '' || currentEvent !== '') {\n      yield { event: currentEvent, data: currentData };\n    }\n  } finally {\n    reader.releaseLock();\n  }\n}\n\nfunction indexOfNewline(s: string): number {\n  for (let i = 0; i < s.length; i += 1) {\n    const c = s[i];\n    if (c === '\\n' || c === '\\r') return i;\n  }\n  return -1;\n}\n","/**\n * `AlmadarClient` — server / Node-side HTTP client targeting `/api/v1/agent/*`.\n * Authenticates with a team-bound API key (`sk_*`) issued from\n * Studio's `/settings/sdk` panel. See `docs/Almadar_Studio_SDK.md` §5.\n *\n * Never instantiate this in a browser bundle — `apiKey` must never leave\n * the customer's server.\n */\n\nimport { parseOrbitalSchema, type OrbitalSchema, type SSEEvent } from '@almadar/core';\nimport type {\n  AlmadarClientOptions,\n  ApiErrorBody,\n  AsyncJobHandle,\n  CompileOptions,\n  CompileResult,\n  EditSchemaPatch,\n  GenerateOptions,\n  GenerateResult,\n} from '../types';\nimport { errorFromBody, ServerError } from './errors';\nimport { parseSSE } from './sseParser';\n\nconst DEFAULT_BASE_URL = 'https://studio.almadar.io';\nconst POLL_BACKOFF_MS: readonly number[] = [1000, 2000, 5000, 10_000, 30_000];\n\ninterface JobStatus {\n  state: 'pending' | 'complete' | 'error';\n  events?: readonly SSEEvent[];\n  result?: GenerateResult;\n  errorCode?: number;\n  errorMessage?: string;\n}\n\nexport class AlmadarClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly fetchImpl: typeof fetch;\n\n  constructor(opts: AlmadarClientOptions) {\n    if (!opts.apiKey || typeof opts.apiKey !== 'string') {\n      throw new Error('AlmadarClient: opts.apiKey is required');\n    }\n    this.apiKey = opts.apiKey;\n    this.baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/$/, '');\n    this.fetchImpl = opts.fetch ?? globalThis.fetch;\n    if (typeof this.fetchImpl !== 'function') {\n      throw new Error('AlmadarClient: no fetch available — pass opts.fetch for Node <18');\n    }\n  }\n\n  async generate(input: GenerateOptions): Promise<GenerateResult> {\n    if (input.async === true) {\n      const handle = await this.requestJson<AsyncJobHandle>('POST', '/api/v1/agent/generate', {\n        prompt: input.prompt,\n        endUserId: input.endUserId,\n        appId: input.appId,\n        async: true,\n        provider: input.provider,\n        model: input.model,\n        catalogMode: input.catalogMode,\n        stdAllowList: input.stdAllowList,\n      });\n      assertString(handle.jobId, 'AsyncJobHandle.jobId');\n      assertString(handle.statusUrl, 'AsyncJobHandle.statusUrl');\n      return this.pollUntilComplete(handle, input.onEvent);\n    }\n    return this.streamGenerate(input);\n  }\n\n  async editSchema(appId: string, patch: EditSchemaPatch): Promise<OrbitalSchema> {\n    if (!appId) throw new Error('AlmadarClient.editSchema: appId is required');\n    const schema = await this.requestJson<OrbitalSchema>('PUT', '/api/v1/agent/edit-schema', {\n      appId,\n      patch,\n    });\n    assertString(schema.name, 'OrbitalSchema.name');\n    return schema;\n  }\n\n  async compileToApp(schema: OrbitalSchema, opts?: CompileOptions): Promise<CompileResult> {\n    const result = await this.requestJson<CompileResult>('POST', '/api/v1/agent/compile', {\n      schema,\n      target: opts?.target,\n      shell: opts?.shell,\n    });\n    assertString(result.downloadUrl, 'CompileResult.downloadUrl');\n    assertString(result.expiresAt, 'CompileResult.expiresAt');\n    return result;\n  }\n\n  private async streamGenerate(input: GenerateOptions): Promise<GenerateResult> {\n    const res = await this.fetchImpl(`${this.baseUrl}/api/v1/agent/generate`, {\n      method: 'POST',\n      headers: this.headers({ accept: 'text/event-stream', contentType: 'application/json' }, input.endUserId),\n      body: JSON.stringify({\n        prompt: input.prompt,\n        endUserId: input.endUserId,\n        appId: input.appId,\n        provider: input.provider,\n        model: input.model,\n        catalogMode: input.catalogMode,\n        stdAllowList: input.stdAllowList,\n      }),\n    });\n    if (!res.ok) throw await this.errorFromResponse(res);\n    if (res.body === null) throw new Error('AlmadarClient.generate: server returned no body');\n\n    let final: GenerateResult | null = null;\n    for await (const raw of parseSSE(res.body)) {\n      const event = parseSseEvent(raw.data);\n      if (event === null) continue;\n      input.onEvent?.(event);\n      if (event.type === 'complete') {\n        if (event.data.schema === undefined) {\n          throw new ServerError({ code: 500, message: '`complete` event did not contain a schema' });\n        }\n        const schema = parseOrbitalSchema(event.data.schema);\n        final = { schema, appId: event.data.appId };\n      } else if (event.type === 'error') {\n        throw errorFromBody({ code: 500, message: event.data.error });\n      }\n    }\n    if (final === null) {\n      throw new ServerError({ code: 500, message: 'SSE stream ended without `complete` event' });\n    }\n    return final;\n  }\n\n  private async pollUntilComplete(\n    handle: AsyncJobHandle,\n    onEvent: GenerateOptions['onEvent'],\n  ): Promise<GenerateResult> {\n    let attempt = 0;\n    for (;;) {\n      const delay = POLL_BACKOFF_MS[Math.min(attempt, POLL_BACKOFF_MS.length - 1)];\n      await sleep(delay);\n      attempt += 1;\n      const status = await this.requestJson<JobStatus>('GET', handle.statusUrl);\n      assertString(status.state, 'JobStatus.state');\n      if (status.events !== undefined && onEvent !== undefined) {\n        for (const e of status.events) onEvent(e);\n      }\n      if (status.state === 'complete') {\n        if (status.result === undefined) {\n          throw new ServerError({ code: 500, message: 'Job complete but no result returned' });\n        }\n        return status.result;\n      }\n      if (status.state === 'error') {\n        throw errorFromBody({\n          code: status.errorCode ?? 500,\n          message: status.errorMessage ?? 'Job failed',\n        });\n      }\n    }\n  }\n\n  private async requestJson<T>(method: string, path: string, body?: object): Promise<T> {\n    const isAbsolute = path.startsWith('http://') || path.startsWith('https://');\n    const url = isAbsolute ? path : `${this.baseUrl}${path}`;\n    const init: RequestInit = {\n      method,\n      headers: this.headers({\n        accept: 'application/json',\n        contentType: body !== undefined ? 'application/json' : undefined,\n      }),\n    };\n    if (body !== undefined) init.body = JSON.stringify(body);\n    const res = await this.fetchImpl(url, init);\n    if (!res.ok) throw await this.errorFromResponse(res);\n    const text = await res.text();\n    if (text === '') {\n      throw new ServerError({ code: 500, message: 'Empty response body' });\n    }\n    const parsed: T = JSON.parse(text);\n    return parsed;\n  }\n\n  private headers(\n    opts: { accept?: string; contentType?: string },\n    endUserId?: string,\n  ): Record<string, string> {\n    const h: Record<string, string> = { authorization: `Bearer ${this.apiKey}` };\n    if (opts.accept !== undefined) h['accept'] = opts.accept;\n    if (opts.contentType !== undefined) h['content-type'] = opts.contentType;\n    if (endUserId !== undefined && endUserId !== '') h['x-end-user-id'] = endUserId;\n    return h;\n  }\n\n  private async errorFromResponse(res: Response): Promise<Error> {\n    const text = await res.text();\n    let body: ApiErrorBody;\n    try {\n      const parsed: ApiErrorBody | null = text === '' ? null : JSON.parse(text);\n      body = parsed !== null && typeof parsed.code === 'number' && typeof parsed.message === 'string'\n        ? parsed\n        : {\n            code: res.status,\n            message: res.statusText !== '' ? res.statusText : 'HTTP error',\n          };\n    } catch {\n      body = { code: res.status, message: text !== '' ? text : res.statusText };\n    }\n    const retryAfter = res.headers.get('retry-after');\n    const err = errorFromBody(body);\n    if (err.name === 'RateLimitedError' && retryAfter !== null) {\n      const seconds = Number(retryAfter);\n      if (Number.isFinite(seconds)) {\n        Object.defineProperty(err, 'retryAfterSeconds', { value: seconds, enumerable: true });\n      }\n    }\n    return err;\n  }\n}\n\n/**\n * Parse one SSE `data:` line into the canonical `SSEEvent` union.\n * The server is the trusted emitter, so we validate only the envelope\n * (object with string `type` and numeric `timestamp`) and cast to the\n * discriminated union. Malformed lines are ignored.\n */\nfunction parseSseEvent(dataLine: string): SSEEvent | null {\n  if (dataLine === '') return null;\n  let payload;\n  try {\n    payload = JSON.parse(dataLine);\n  } catch {\n    return null;\n  }\n  if (payload === null || typeof payload !== 'object' || Array.isArray(payload)) return null;\n  if (typeof payload.type !== 'string' || typeof payload.timestamp !== 'number') return null;\n  return payload as SSEEvent;\n}\n\nfunction assertString(v: string | undefined, name: string): asserts v is string {\n  if (typeof v !== 'string' || v === '') {\n    throw new ServerError({ code: 500, message: `Malformed server response: ${name} is not a string` });\n  }\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n"]}
+{"version":3,"sources":["../src/react/OrbitalConfigPanel.tsx","../src/react/AlmadarApp.tsx","../src/client/errors.ts","../src/client/sseParser.ts","../src/client/AlmadarClient.ts"],"names":["parseSchema","useMemo","useState","jsx","jsxs"],"mappings":"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","file":"index.js","sourcesContent":["'use client';\n\n/**\n * OrbitalConfigPanel — auto-derived control rail for an orbital schema.\n *\n * Finds the first trait that declares a non-empty `config`, filters its fields\n * by the consumer-supplied `exposedTiers`, and renders `@almadar/ui`'s\n * `PropertyInspector`. Every control change deep-clones the schema, writes the\n * new value into the matching field's `default`, and emits the mutated schema\n * so the host can pass it to `OrbPreview`.\n */\n\nimport React, { useMemo, useState } from 'react';\nimport type {\n  ConfigFieldDeclaration,\n  DeclaredTraitConfig,\n  OrbitalSchema,\n  Trait,\n  TraitConfigValue,\n} from '@almadar/core';\nimport { PropertyInspector } from '@almadar/ui/components';\nimport { Stack, Box, Typography } from '@almadar/ui/components';\n\ninterface ConfigTraitTarget {\n  name: string;\n  config: DeclaredTraitConfig;\n}\n\nfunction parseSchema(schema: string | OrbitalSchema): OrbitalSchema {\n  if (typeof schema === 'string') {\n    return JSON.parse(schema) as OrbitalSchema;\n  }\n  return schema;\n}\n\nfunction deepClone<T>(value: T): T {\n  return JSON.parse(JSON.stringify(value)) as T;\n}\n\nfunction findConfigTrait(schema: OrbitalSchema | null): ConfigTraitTarget | null {\n  if (!schema?.orbitals) return null;\n  for (const orbital of schema.orbitals) {\n    for (const traitRef of orbital.traits ?? []) {\n      if (typeof traitRef !== 'object' || traitRef === null) continue;\n      const trait = traitRef as Trait | { ref?: string; config?: DeclaredTraitConfig };\n      if (trait.config && Object.keys(trait.config).length > 0) {\n        const name = 'name' in trait && typeof trait.name === 'string' ? trait.name : 'Config';\n        return { name, config: trait.config };\n      }\n    }\n  }\n  return null;\n}\n\nfunction applyConfigOverride(\n  schema: OrbitalSchema,\n  field: string,\n  value: TraitConfigValue,\n): OrbitalSchema {\n  const next = deepClone(schema);\n  for (const orbital of next.orbitals ?? []) {\n    for (const traitRef of orbital.traits ?? []) {\n      if (typeof traitRef !== 'object' || traitRef === null) continue;\n      const trait = traitRef as { config?: Record<string, ConfigFieldDeclaration> };\n      if (trait.config && field in trait.config) {\n        trait.config[field] = { ...trait.config[field], default: value };\n        return next;\n      }\n    }\n  }\n  return next;\n}\n\nexport interface OrbitalConfigPanelProps {\n  schema: string | OrbitalSchema;\n  exposedTiers?: string[];\n  position?: 'right' | 'bottom';\n  onSchemaChange?: (schema: OrbitalSchema) => void;\n}\n\nexport function OrbitalConfigPanel({\n  schema,\n  exposedTiers,\n  position = 'right',\n  onSchemaChange,\n}: OrbitalConfigPanelProps): React.ReactElement | null {\n  const parsed = useMemo(() => parseSchema(schema), [schema]);\n  const target = useMemo(() => findConfigTrait(parsed), [parsed]);\n  const [values, setValues] = useState<Record<string, TraitConfigValue>>({});\n\n  if (!target) return null;\n\n  const sortedConfig: DeclaredTraitConfig = Object.fromEntries(\n    Object.entries(target.config).sort(([a], [b]) => a.localeCompare(b)),\n  );\n\n  const handleChange = (field: string, value: TraitConfigValue): void => {\n    setValues((prev) => ({ ...prev, [field]: value }));\n    const nextSchema = applyConfigOverride(parsed, field, value);\n    onSchemaChange?.(nextSchema);\n  };\n\n  const handleReset = (): void => {\n    setValues({});\n    onSchemaChange?.(parsed);\n  };\n\n  const isHorizontal = position === 'bottom';\n\n  return (\n    <Box\n      className={`${\n        isHorizontal ? 'w-full border-t' : 'h-full w-80 flex-shrink-0 border-l'\n      } border-border bg-card p-3 overflow-y-auto`}\n    >\n      <Stack direction=\"vertical\" gap=\"sm\">\n        <Typography variant=\"caption\" weight=\"bold\" color=\"muted\">\n          Controls\n        </Typography>\n        <PropertyInspector\n          title={target.name}\n          config={sortedConfig}\n          values={values}\n          onChange={handleChange}\n          onReset={handleReset}\n          tiers={exposedTiers}\n        />\n      </Stack>\n    </Box>\n  );\n}\n\nOrbitalConfigPanel.displayName = 'OrbitalConfigPanel';\n","'use client';\n\n/**\n * `<AlmadarApp />` — renders an orbital schema in the customer's React tree.\n *\n * Thin facade over `@almadar/ui`'s `OrbPreview` (server-backed) and\n * `BrowserPlayground` (in-browser mock server). The `mode` prop picks the\n * runtime path:\n *   - `static`: pure OrbPreview with `mockData`\n *   - `mock`  : BrowserPlayground (in-browser server, faker-seeded)\n *   - `server`: OrbPreview with `serverUrl`\n *\n * Lazy-imports the heavy runtime bundle so the SDK is import-cheap in Next.js\n * server components; the actual render happens client-side under a Suspense\n * boundary. CSS is imported as a side-effect at module load.\n */\n\nimport { lazy, Suspense, useEffect, useMemo, useState } from 'react';\nimport type { AlmadarAppProps } from '../types';\nimport type { OrbitalSchema } from '@almadar/core';\nimport { OrbitalConfigPanel } from './OrbitalConfigPanel';\n// Required global styles. Customers who self-manage Tailwind can import from\n// the (forthcoming) `@almadar/sdk/react/no-css` entry instead.\nimport '@almadar/ui/index.css';\n\nconst OrbPreviewLazy = lazy(async () => {\n  const mod = await import('@almadar/ui/runtime');\n  return { default: mod.OrbPreview };\n});\n\nconst BrowserPlaygroundLazy = lazy(async () => {\n  const mod = await import('@almadar/ui/runtime');\n  return { default: mod.BrowserPlayground };\n});\n\nfunction parseSchema(schema: string | OrbitalSchema): OrbitalSchema {\n  if (typeof schema === 'string') {\n    return JSON.parse(schema) as OrbitalSchema;\n  }\n  return schema;\n}\n\nexport function AlmadarApp(props: AlmadarAppProps) {\n  const mode = props.mode ?? 'static';\n  const parsedSchema = useMemo(() => parseSchema(props.schema), [props.schema]);\n  const [controlledSchema, setControlledSchema] = useState<OrbitalSchema>(parsedSchema);\n\n  // Reset controlled schema when the incoming schema changes.\n  useEffect(() => {\n    setControlledSchema(parsedSchema);\n  }, [parsedSchema]);\n\n  const effectiveSchema = props.exposedTiers && mode !== 'server' ? controlledSchema : parsedSchema;\n  const showControls = props.exposedTiers && props.exposedTiers.length > 0 && mode !== 'server';\n\n  const preview = mode === 'mock' ? (\n    <BrowserPlaygroundLazy\n      schema={effectiveSchema}\n      mode=\"mock\"\n      initialPagePath={props.initialPagePath}\n      height={props.height}\n      className={props.className}\n    />\n  ) : (\n    <OrbPreviewLazy\n      schema={effectiveSchema}\n      mockData={props.data}\n      serverUrl={props.serverUrl}\n      initialPagePath={props.initialPagePath}\n      height={props.height}\n      className={props.className}\n    />\n  );\n\n  if (!showControls) {\n    return (\n      <Suspense fallback={null}>\n        {preview}\n      </Suspense>\n    );\n  }\n\n  const isBottom = props.controlsPosition === 'bottom';\n\n  return (\n    <Suspense fallback={null}>\n      <div\n        className={`flex ${isBottom ? 'flex-col' : 'flex-row'} w-full h-full`}\n        style={{ height: props.height }}\n      >\n        <div className=\"flex-1 min-w-0\">\n          {preview}\n        </div>\n        <OrbitalConfigPanel\n          schema={parsedSchema}\n          exposedTiers={props.exposedTiers}\n          position={props.controlsPosition}\n          onSchemaChange={setControlledSchema}\n        />\n      </div>\n    </Suspense>\n  );\n}\n\nAlmadarApp.displayName = 'AlmadarApp';\n","/**\n * Typed SDK errors. Server emits a structured `ApiErrorBody`; the HTTP layer\n * maps the `code` to one of these subclasses. Customers `catch` by class.\n */\n\nimport type { ApiErrorBody } from '../types';\n\nexport class AlmadarError extends Error {\n  readonly code: number;\n  readonly details?: ApiErrorBody['details'];\n  constructor(body: ApiErrorBody) {\n    super(body.message);\n    this.name = 'AlmadarError';\n    this.code = body.code;\n    this.details = body.details;\n  }\n}\n\n/** 4001 — invalid, revoked, or missing API key. */\nexport class ApiKeyError extends AlmadarError {\n  constructor(body: ApiErrorBody) {\n    super(body);\n    this.name = 'ApiKeyError';\n  }\n}\n\n/** 4029 — team cap (feature counter) exceeded. Retry after a billing cycle. */\nexport class RateLimitedError extends AlmadarError {\n  readonly retryAfterSeconds?: number;\n  constructor(body: ApiErrorBody, retryAfterSeconds?: number) {\n    super(body);\n    this.name = 'RateLimitedError';\n    this.retryAfterSeconds = retryAfterSeconds;\n  }\n}\n\n/** 4040 — the team's behavior catalog (subset/replace mode) cannot serve the request. */\nexport class CatalogOutOfScopeError extends AlmadarError {\n  constructor(body: ApiErrorBody) {\n    super(body);\n    this.name = 'CatalogOutOfScopeError';\n  }\n}\n\n/** Anything else from the server with a recognized envelope but no specific subclass. */\nexport class ServerError extends AlmadarError {\n  constructor(body: ApiErrorBody) {\n    super(body);\n    this.name = 'ServerError';\n  }\n}\n\nexport function errorFromBody(body: ApiErrorBody): AlmadarError {\n  switch (body.code) {\n    case 4001:\n      return new ApiKeyError(body);\n    case 4029:\n      return new RateLimitedError(body);\n    case 4040:\n      return new CatalogOutOfScopeError(body);\n    default:\n      return new ServerError(body);\n  }\n}\n","/**\n * Minimal Server-Sent Events parser. Reads a `ReadableStream<Uint8Array>`\n * (the body of a `fetch` Response) and yields decoded events. Universal:\n * works in browser, Node 18+, Deno, Bun.\n *\n * Spec subset implemented:\n *   - `event:` and `data:` fields\n *   - dispatch on blank line\n *   - newline-tolerant (CRLF + LF)\n *   - skips comments (`:`-prefixed lines)\n *\n * Not implemented (we don't need them):\n *   - `id:` / `retry:` fields\n *   - reconnection / last-event-id\n */\n\nexport interface RawSseEvent {\n  /** `event:` field value. Empty string when absent — matches the spec default. */\n  event: string;\n  /** Concatenated `data:` lines, joined by newlines. */\n  data: string;\n}\n\nexport async function* parseSSE(\n  stream: ReadableStream<Uint8Array>,\n): AsyncGenerator<RawSseEvent, void, void> {\n  const reader = stream.getReader();\n  const decoder = new TextDecoder('utf-8');\n  let buffer = '';\n  let currentEvent = '';\n  let currentData = '';\n\n  try {\n    for (;;) {\n      const { value, done } = await reader.read();\n      if (done) break;\n      buffer += decoder.decode(value, { stream: true });\n\n      let newlineIdx: number;\n      while ((newlineIdx = indexOfNewline(buffer)) !== -1) {\n        const rawLine = buffer.slice(0, newlineIdx);\n        buffer = buffer.slice(newlineIdx + (buffer[newlineIdx] === '\\r' && buffer[newlineIdx + 1] === '\\n' ? 2 : 1));\n\n        if (rawLine === '') {\n          if (currentData !== '' || currentEvent !== '') {\n            yield { event: currentEvent, data: currentData };\n            currentEvent = '';\n            currentData = '';\n          }\n          continue;\n        }\n        if (rawLine.startsWith(':')) continue;\n\n        const colon = rawLine.indexOf(':');\n        const field = colon === -1 ? rawLine : rawLine.slice(0, colon);\n        const rawValue = colon === -1 ? '' : rawLine.slice(colon + 1);\n        const value2 = rawValue.startsWith(' ') ? rawValue.slice(1) : rawValue;\n\n        if (field === 'event') {\n          currentEvent = value2;\n        } else if (field === 'data') {\n          currentData = currentData === '' ? value2 : `${currentData}\\n${value2}`;\n        }\n      }\n    }\n    if (currentData !== '' || currentEvent !== '') {\n      yield { event: currentEvent, data: currentData };\n    }\n  } finally {\n    reader.releaseLock();\n  }\n}\n\nfunction indexOfNewline(s: string): number {\n  for (let i = 0; i < s.length; i += 1) {\n    const c = s[i];\n    if (c === '\\n' || c === '\\r') return i;\n  }\n  return -1;\n}\n","/**\n * `AlmadarClient` — server / Node-side HTTP client targeting `/api/v1/agent/*`.\n * Authenticates with a team-bound API key (`sk_*`) issued from\n * Studio's `/settings/sdk` panel. See `docs/Almadar_Studio_SDK.md` §5.\n *\n * Never instantiate this in a browser bundle — `apiKey` must never leave\n * the customer's server.\n */\n\nimport { parseOrbitalSchema, type OrbitalSchema, type SSEEvent } from '@almadar/core';\nimport type {\n  AlmadarClientOptions,\n  ApiErrorBody,\n  AsyncJobHandle,\n  CompileOptions,\n  CompileResult,\n  EditSchemaPatch,\n  GenerateOptions,\n  GenerateResult,\n} from '../types';\nimport { errorFromBody, ServerError } from './errors';\nimport { parseSSE } from './sseParser';\n\nconst DEFAULT_BASE_URL = 'https://studio.almadar.io';\nconst POLL_BACKOFF_MS: readonly number[] = [1000, 2000, 5000, 10_000, 30_000];\n\ninterface JobStatus {\n  state: 'pending' | 'complete' | 'error';\n  events?: readonly SSEEvent[];\n  result?: GenerateResult;\n  errorCode?: number;\n  errorMessage?: string;\n}\n\nexport class AlmadarClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly fetchImpl: typeof fetch;\n\n  constructor(opts: AlmadarClientOptions) {\n    if (!opts.apiKey || typeof opts.apiKey !== 'string') {\n      throw new Error('AlmadarClient: opts.apiKey is required');\n    }\n    this.apiKey = opts.apiKey;\n    this.baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/$/, '');\n    this.fetchImpl = opts.fetch ?? globalThis.fetch;\n    if (typeof this.fetchImpl !== 'function') {\n      throw new Error('AlmadarClient: no fetch available — pass opts.fetch for Node <18');\n    }\n  }\n\n  async generate(input: GenerateOptions): Promise<GenerateResult> {\n    if (input.async === true) {\n      const handle = await this.requestJson<AsyncJobHandle>('POST', '/api/v1/agent/generate', {\n        prompt: input.prompt,\n        endUserId: input.endUserId,\n        appId: input.appId,\n        async: true,\n        provider: input.provider,\n        model: input.model,\n        catalogMode: input.catalogMode,\n        stdAllowList: input.stdAllowList,\n      });\n      assertString(handle.jobId, 'AsyncJobHandle.jobId');\n      assertString(handle.statusUrl, 'AsyncJobHandle.statusUrl');\n      return this.pollUntilComplete(handle, input.onEvent);\n    }\n    return this.streamGenerate(input);\n  }\n\n  async editSchema(appId: string, patch: EditSchemaPatch): Promise<OrbitalSchema> {\n    if (!appId) throw new Error('AlmadarClient.editSchema: appId is required');\n    const schema = await this.requestJson<OrbitalSchema>('PUT', '/api/v1/agent/edit-schema', {\n      appId,\n      patch,\n    });\n    assertString(schema.name, 'OrbitalSchema.name');\n    return schema;\n  }\n\n  async compileToApp(schema: OrbitalSchema, opts?: CompileOptions): Promise<CompileResult> {\n    const result = await this.requestJson<CompileResult>('POST', '/api/v1/agent/compile', {\n      schema,\n      target: opts?.target,\n      shell: opts?.shell,\n    });\n    assertString(result.downloadUrl, 'CompileResult.downloadUrl');\n    assertString(result.expiresAt, 'CompileResult.expiresAt');\n    return result;\n  }\n\n  private async streamGenerate(input: GenerateOptions): Promise<GenerateResult> {\n    const res = await this.fetchImpl(`${this.baseUrl}/api/v1/agent/generate`, {\n      method: 'POST',\n      headers: this.headers({ accept: 'text/event-stream', contentType: 'application/json' }, input.endUserId),\n      body: JSON.stringify({\n        prompt: input.prompt,\n        endUserId: input.endUserId,\n        appId: input.appId,\n        provider: input.provider,\n        model: input.model,\n        catalogMode: input.catalogMode,\n        stdAllowList: input.stdAllowList,\n      }),\n    });\n    if (!res.ok) throw await this.errorFromResponse(res);\n    if (res.body === null) throw new Error('AlmadarClient.generate: server returned no body');\n\n    let final: GenerateResult | null = null;\n    for await (const raw of parseSSE(res.body)) {\n      const event = parseSseEvent(raw.data);\n      if (event === null) continue;\n      input.onEvent?.(event);\n      if (event.type === 'complete') {\n        if (event.data.schema === undefined) {\n          throw new ServerError({ code: 500, message: '`complete` event did not contain a schema' });\n        }\n        const schema = parseOrbitalSchema(event.data.schema);\n        final = { schema, appId: event.data.appId };\n      } else if (event.type === 'error') {\n        throw errorFromBody({ code: 500, message: event.data.error });\n      }\n    }\n    if (final === null) {\n      throw new ServerError({ code: 500, message: 'SSE stream ended without `complete` event' });\n    }\n    return final;\n  }\n\n  private async pollUntilComplete(\n    handle: AsyncJobHandle,\n    onEvent: GenerateOptions['onEvent'],\n  ): Promise<GenerateResult> {\n    let attempt = 0;\n    for (;;) {\n      const delay = POLL_BACKOFF_MS[Math.min(attempt, POLL_BACKOFF_MS.length - 1)];\n      await sleep(delay);\n      attempt += 1;\n      const status = await this.requestJson<JobStatus>('GET', handle.statusUrl);\n      assertString(status.state, 'JobStatus.state');\n      if (status.events !== undefined && onEvent !== undefined) {\n        for (const e of status.events) onEvent(e);\n      }\n      if (status.state === 'complete') {\n        if (status.result === undefined) {\n          throw new ServerError({ code: 500, message: 'Job complete but no result returned' });\n        }\n        return status.result;\n      }\n      if (status.state === 'error') {\n        throw errorFromBody({\n          code: status.errorCode ?? 500,\n          message: status.errorMessage ?? 'Job failed',\n        });\n      }\n    }\n  }\n\n  private async requestJson<T>(method: string, path: string, body?: object): Promise<T> {\n    const isAbsolute = path.startsWith('http://') || path.startsWith('https://');\n    const url = isAbsolute ? path : `${this.baseUrl}${path}`;\n    const init: RequestInit = {\n      method,\n      headers: this.headers({\n        accept: 'application/json',\n        contentType: body !== undefined ? 'application/json' : undefined,\n      }),\n    };\n    if (body !== undefined) init.body = JSON.stringify(body);\n    const res = await this.fetchImpl(url, init);\n    if (!res.ok) throw await this.errorFromResponse(res);\n    const text = await res.text();\n    if (text === '') {\n      throw new ServerError({ code: 500, message: 'Empty response body' });\n    }\n    const parsed: T = JSON.parse(text);\n    return parsed;\n  }\n\n  private headers(\n    opts: { accept?: string; contentType?: string },\n    endUserId?: string,\n  ): Record<string, string> {\n    const h: Record<string, string> = { authorization: `Bearer ${this.apiKey}` };\n    if (opts.accept !== undefined) h['accept'] = opts.accept;\n    if (opts.contentType !== undefined) h['content-type'] = opts.contentType;\n    if (endUserId !== undefined && endUserId !== '') h['x-end-user-id'] = endUserId;\n    return h;\n  }\n\n  private async errorFromResponse(res: Response): Promise<Error> {\n    const text = await res.text();\n    let body: ApiErrorBody;\n    try {\n      const parsed: ApiErrorBody | null = text === '' ? null : JSON.parse(text);\n      body = parsed !== null && typeof parsed.code === 'number' && typeof parsed.message === 'string'\n        ? parsed\n        : {\n            code: res.status,\n            message: res.statusText !== '' ? res.statusText : 'HTTP error',\n          };\n    } catch {\n      body = { code: res.status, message: text !== '' ? text : res.statusText };\n    }\n    const retryAfter = res.headers.get('retry-after');\n    const err = errorFromBody(body);\n    if (err.name === 'RateLimitedError' && retryAfter !== null) {\n      const seconds = Number(retryAfter);\n      if (Number.isFinite(seconds)) {\n        Object.defineProperty(err, 'retryAfterSeconds', { value: seconds, enumerable: true });\n      }\n    }\n    return err;\n  }\n}\n\n/**\n * Parse one SSE `data:` line into the canonical `SSEEvent` union.\n * The server is the trusted emitter, so we validate only the envelope\n * (object with string `type` and numeric `timestamp`) and cast to the\n * discriminated union. Malformed lines are ignored.\n */\nfunction parseSseEvent(dataLine: string): SSEEvent | null {\n  if (dataLine === '') return null;\n  let payload;\n  try {\n    payload = JSON.parse(dataLine);\n  } catch {\n    return null;\n  }\n  if (payload === null || typeof payload !== 'object' || Array.isArray(payload)) return null;\n  if (typeof payload.type !== 'string' || typeof payload.timestamp !== 'number') return null;\n  return payload as SSEEvent;\n}\n\nfunction assertString(v: string | undefined, name: string): asserts v is string {\n  if (typeof v !== 'string' || v === '') {\n    throw new ServerError({ code: 500, message: `Malformed server response: ${name} is not a string` });\n  }\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n"]}

package/dist/react/index.d.ts

@@ -1,11 +1,29 @@
-import * as react from 'react';
-import { A as AlmadarAppProps } from '../types-D-q0c5Yt.js';
-export { useEventBus as useOrbBus } from '@almadar/ui/hooks';
+export { A as AlmadarApp } from '../AlmadarApp-DgwtnIRy.js';
+import react__default from 'react';
+import { OrbitalSchema } from '@almadar/core';
 export { EntityData, EventPayload, OrbitalSchema, SSEEvent } from '@almadar/core';
+export { useEventBus as useOrbBus } from '@almadar/ui/hooks';
+export { A as AlmadarAppProps, O as OrbitalConfigPanelProps } from '../types-C6RJADoY.js';
 
-declare function AlmadarApp(props: AlmadarAppProps): react.JSX.Element;
-declare namespace AlmadarApp {
+/**
+ * OrbitalConfigPanel — auto-derived control rail for an orbital schema.
+ *
+ * Finds the first trait that declares a non-empty `config`, filters its fields
+ * by the consumer-supplied `exposedTiers`, and renders `@almadar/ui`'s
+ * `PropertyInspector`. Every control change deep-clones the schema, writes the
+ * new value into the matching field's `default`, and emits the mutated schema
+ * so the host can pass it to `OrbPreview`.
+ */
+
+interface OrbitalConfigPanelProps {
+    schema: string | OrbitalSchema;
+    exposedTiers?: string[];
+    position?: 'right' | 'bottom';
+    onSchemaChange?: (schema: OrbitalSchema) => void;
+}
+declare function OrbitalConfigPanel({ schema, exposedTiers, position, onSchemaChange, }: OrbitalConfigPanelProps): react__default.ReactElement | null;
+declare namespace OrbitalConfigPanel {
     var displayName: string;
 }
 
-export { AlmadarApp, AlmadarAppProps };
+export { OrbitalConfigPanel };

package/dist/react/index.js

@@ -1,9 +1,92 @@
-import { lazy, Suspense } from 'react';
+import { lazy, useMemo, useState, useEffect, Suspense } from 'react';
+import { Box, Stack, Typography, PropertyInspector } from '@almadar/ui/components';
+import { jsx, jsxs } from 'react/jsx-runtime';
 import '@almadar/ui/index.css';
-import { jsx } from 'react/jsx-runtime';
 export { useEventBus as useOrbBus } from '@almadar/ui/hooks';
 
 // src/react/AlmadarApp.tsx
+function parseSchema(schema) {
+  if (typeof schema === "string") {
+    return JSON.parse(schema);
+  }
+  return schema;
+}
+function deepClone(value) {
+  return JSON.parse(JSON.stringify(value));
+}
+function findConfigTrait(schema) {
+  if (!schema?.orbitals) return null;
+  for (const orbital of schema.orbitals) {
+    for (const traitRef of orbital.traits ?? []) {
+      if (typeof traitRef !== "object" || traitRef === null) continue;
+      const trait = traitRef;
+      if (trait.config && Object.keys(trait.config).length > 0) {
+        const name = "name" in trait && typeof trait.name === "string" ? trait.name : "Config";
+        return { name, config: trait.config };
+      }
+    }
+  }
+  return null;
+}
+function applyConfigOverride(schema, field, value) {
+  const next = deepClone(schema);
+  for (const orbital of next.orbitals ?? []) {
+    for (const traitRef of orbital.traits ?? []) {
+      if (typeof traitRef !== "object" || traitRef === null) continue;
+      const trait = traitRef;
+      if (trait.config && field in trait.config) {
+        trait.config[field] = { ...trait.config[field], default: value };
+        return next;
+      }
+    }
+  }
+  return next;
+}
+function OrbitalConfigPanel({
+  schema,
+  exposedTiers,
+  position = "right",
+  onSchemaChange
+}) {
+  const parsed = useMemo(() => parseSchema(schema), [schema]);
+  const target = useMemo(() => findConfigTrait(parsed), [parsed]);
+  const [values, setValues] = useState({});
+  if (!target) return null;
+  const sortedConfig = Object.fromEntries(
+    Object.entries(target.config).sort(([a], [b]) => a.localeCompare(b))
+  );
+  const handleChange = (field, value) => {
+    setValues((prev) => ({ ...prev, [field]: value }));
+    const nextSchema = applyConfigOverride(parsed, field, value);
+    onSchemaChange?.(nextSchema);
+  };
+  const handleReset = () => {
+    setValues({});
+    onSchemaChange?.(parsed);
+  };
+  const isHorizontal = position === "bottom";
+  return /* @__PURE__ */ jsx(
+    Box,
+    {
+      className: `${isHorizontal ? "w-full border-t" : "h-full w-80 flex-shrink-0 border-l"} border-border bg-card p-3 overflow-y-auto`,
+      children: /* @__PURE__ */ jsxs(Stack, { direction: "vertical", gap: "sm", children: [
+        /* @__PURE__ */ jsx(Typography, { variant: "caption", weight: "bold", color: "muted", children: "Controls" }),
+        /* @__PURE__ */ jsx(
+          PropertyInspector,
+          {
+            title: target.name,
+            config: sortedConfig,
+            values,
+            onChange: handleChange,
+            onReset: handleReset,
+            tiers: exposedTiers
+          }
+        )
+      ] })
+    }
+  );
+}
+OrbitalConfigPanel.displayName = "OrbitalConfigPanel";
 var OrbPreviewLazy = lazy(async () => {
   const mod = await import('@almadar/ui/runtime');
   return { default: mod.OrbPreview };
@@ -12,12 +95,25 @@ var BrowserPlaygroundLazy = lazy(async () => {
   const mod = await import('@almadar/ui/runtime');
   return { default: mod.BrowserPlayground };
 });
+function parseSchema2(schema) {
+  if (typeof schema === "string") {
+    return JSON.parse(schema);
+  }
+  return schema;
+}
 function AlmadarApp(props) {
   const mode = props.mode ?? "static";
-  return /* @__PURE__ */ jsx(Suspense, { fallback: null, children: mode === "mock" ? /* @__PURE__ */ jsx(
+  const parsedSchema = useMemo(() => parseSchema2(props.schema), [props.schema]);
+  const [controlledSchema, setControlledSchema] = useState(parsedSchema);
+  useEffect(() => {
+    setControlledSchema(parsedSchema);
+  }, [parsedSchema]);
+  const effectiveSchema = props.exposedTiers && mode !== "server" ? controlledSchema : parsedSchema;
+  const showControls = props.exposedTiers && props.exposedTiers.length > 0 && mode !== "server";
+  const preview = mode === "mock" ? /* @__PURE__ */ jsx(
     BrowserPlaygroundLazy,
     {
-      schema: props.schema,
+      schema: effectiveSchema,
       mode: "mock",
       initialPagePath: props.initialPagePath,
       height: props.height,
@@ -26,17 +122,40 @@ function AlmadarApp(props) {
   ) : /* @__PURE__ */ jsx(
     OrbPreviewLazy,
     {
-      schema: props.schema,
+      schema: effectiveSchema,
       mockData: props.data,
       serverUrl: props.serverUrl,
       initialPagePath: props.initialPagePath,
       height: props.height,
       className: props.className
     }
+  );
+  if (!showControls) {
+    return /* @__PURE__ */ jsx(Suspense, { fallback: null, children: preview });
+  }
+  const isBottom = props.controlsPosition === "bottom";
+  return /* @__PURE__ */ jsx(Suspense, { fallback: null, children: /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: `flex ${isBottom ? "flex-col" : "flex-row"} w-full h-full`,
+      style: { height: props.height },
+      children: [
+        /* @__PURE__ */ jsx("div", { className: "flex-1 min-w-0", children: preview }),
+        /* @__PURE__ */ jsx(
+          OrbitalConfigPanel,
+          {
+            schema: parsedSchema,
+            exposedTiers: props.exposedTiers,
+            position: props.controlsPosition,
+            onSchemaChange: setControlledSchema
+          }
+        )
+      ]
+    }
   ) });
 }
 AlmadarApp.displayName = "AlmadarApp";
 
-export { AlmadarApp };
+export { AlmadarApp, OrbitalConfigPanel };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/react/AlmadarApp.tsx"],"names":[],"mappings":";;;;;;AAuBA,IAAM,cAAA,GAAiB,KAAK,YAAY;AACtC,EAAA,MAAM,GAAA,GAAM,MAAM,OAAO,qBAAqB,CAAA;AAC9C,EAAA,OAAO,EAAE,OAAA,EAAS,GAAA,CAAI,UAAA,EAAW;AACnC,CAAC,CAAA;AAED,IAAM,qBAAA,GAAwB,KAAK,YAAY;AAC7C,EAAA,MAAM,GAAA,GAAM,MAAM,OAAO,qBAAqB,CAAA;AAC9C,EAAA,OAAO,EAAE,OAAA,EAAS,GAAA,CAAI,iBAAA,EAAkB;AAC1C,CAAC,CAAA;AAEM,SAAS,WAAW,KAAA,EAAwB;AACjD,EAAA,MAAM,IAAA,GAAO,MAAM,IAAA,IAAQ,QAAA;AAE3B,EAAA,uBACE,GAAA,CAAC,QAAA,EAAA,EAAS,QAAA,EAAU,IAAA,EACjB,mBAAS,MAAA,mBACR,GAAA;AAAA,IAAC,qBAAA;AAAA,IAAA;AAAA,MACC,QAAQ,KAAA,CAAM,MAAA;AAAA,MACd,IAAA,EAAK,MAAA;AAAA,MACL,iBAAiB,KAAA,CAAM,eAAA;AAAA,MACvB,QAAQ,KAAA,CAAM,MAAA;AAAA,MACd,WAAW,KAAA,CAAM;AAAA;AAAA,GACnB,mBAEA,GAAA;AAAA,IAAC,cAAA;AAAA,IAAA;AAAA,MACC,QAAQ,KAAA,CAAM,MAAA;AAAA,MACd,UAAU,KAAA,CAAM,IAAA;AAAA,MAChB,WAAW,KAAA,CAAM,SAAA;AAAA,MACjB,iBAAiB,KAAA,CAAM,eAAA;AAAA,MACvB,QAAQ,KAAA,CAAM,MAAA;AAAA,MACd,WAAW,KAAA,CAAM;AAAA;AAAA,GACnB,EAEJ,CAAA;AAEJ;AAEA,UAAA,CAAW,WAAA,GAAc,YAAA","file":"index.js","sourcesContent":["'use client';\n\n/**\n * `<AlmadarApp />` — renders an orbital schema in the customer's React tree.\n *\n * Thin facade over `@almadar/ui`'s `OrbPreview` (server-backed) and\n * `BrowserPlayground` (in-browser mock server). The `mode` prop picks the\n * runtime path:\n *   - `static`: pure OrbPreview with `mockData`\n *   - `mock`  : BrowserPlayground (in-browser server, faker-seeded)\n *   - `server`: OrbPreview with `serverUrl`\n *\n * Lazy-imports the heavy runtime bundle so the SDK is import-cheap in Next.js\n * server components; the actual render happens client-side under a Suspense\n * boundary. CSS is imported as a side-effect at module load.\n */\n\nimport { lazy, Suspense } from 'react';\nimport type { AlmadarAppProps } from '../types';\n// Required global styles. Customers who self-manage Tailwind can import from\n// the (forthcoming) `@almadar/sdk/react/no-css` entry instead.\nimport '@almadar/ui/index.css';\n\nconst OrbPreviewLazy = lazy(async () => {\n  const mod = await import('@almadar/ui/runtime');\n  return { default: mod.OrbPreview };\n});\n\nconst BrowserPlaygroundLazy = lazy(async () => {\n  const mod = await import('@almadar/ui/runtime');\n  return { default: mod.BrowserPlayground };\n});\n\nexport function AlmadarApp(props: AlmadarAppProps) {\n  const mode = props.mode ?? 'static';\n\n  return (\n    <Suspense fallback={null}>\n      {mode === 'mock' ? (\n        <BrowserPlaygroundLazy\n          schema={props.schema}\n          mode=\"mock\"\n          initialPagePath={props.initialPagePath}\n          height={props.height}\n          className={props.className}\n        />\n      ) : (\n        <OrbPreviewLazy\n          schema={props.schema}\n          mockData={props.data}\n          serverUrl={props.serverUrl}\n          initialPagePath={props.initialPagePath}\n          height={props.height}\n          className={props.className}\n        />\n      )}\n    </Suspense>\n  );\n}\n\nAlmadarApp.displayName = 'AlmadarApp';\n"]}
+{"version":3,"sources":["../../src/react/OrbitalConfigPanel.tsx","../../src/react/AlmadarApp.tsx"],"names":["parseSchema","useMemo","useState","jsx","jsxs"],"mappings":"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","file":"index.js","sourcesContent":["'use client';\n\n/**\n * OrbitalConfigPanel — auto-derived control rail for an orbital schema.\n *\n * Finds the first trait that declares a non-empty `config`, filters its fields\n * by the consumer-supplied `exposedTiers`, and renders `@almadar/ui`'s\n * `PropertyInspector`. Every control change deep-clones the schema, writes the\n * new value into the matching field's `default`, and emits the mutated schema\n * so the host can pass it to `OrbPreview`.\n */\n\nimport React, { useMemo, useState } from 'react';\nimport type {\n  ConfigFieldDeclaration,\n  DeclaredTraitConfig,\n  OrbitalSchema,\n  Trait,\n  TraitConfigValue,\n} from '@almadar/core';\nimport { PropertyInspector } from '@almadar/ui/components';\nimport { Stack, Box, Typography } from '@almadar/ui/components';\n\ninterface ConfigTraitTarget {\n  name: string;\n  config: DeclaredTraitConfig;\n}\n\nfunction parseSchema(schema: string | OrbitalSchema): OrbitalSchema {\n  if (typeof schema === 'string') {\n    return JSON.parse(schema) as OrbitalSchema;\n  }\n  return schema;\n}\n\nfunction deepClone<T>(value: T): T {\n  return JSON.parse(JSON.stringify(value)) as T;\n}\n\nfunction findConfigTrait(schema: OrbitalSchema | null): ConfigTraitTarget | null {\n  if (!schema?.orbitals) return null;\n  for (const orbital of schema.orbitals) {\n    for (const traitRef of orbital.traits ?? []) {\n      if (typeof traitRef !== 'object' || traitRef === null) continue;\n      const trait = traitRef as Trait | { ref?: string; config?: DeclaredTraitConfig };\n      if (trait.config && Object.keys(trait.config).length > 0) {\n        const name = 'name' in trait && typeof trait.name === 'string' ? trait.name : 'Config';\n        return { name, config: trait.config };\n      }\n    }\n  }\n  return null;\n}\n\nfunction applyConfigOverride(\n  schema: OrbitalSchema,\n  field: string,\n  value: TraitConfigValue,\n): OrbitalSchema {\n  const next = deepClone(schema);\n  for (const orbital of next.orbitals ?? []) {\n    for (const traitRef of orbital.traits ?? []) {\n      if (typeof traitRef !== 'object' || traitRef === null) continue;\n      const trait = traitRef as { config?: Record<string, ConfigFieldDeclaration> };\n      if (trait.config && field in trait.config) {\n        trait.config[field] = { ...trait.config[field], default: value };\n        return next;\n      }\n    }\n  }\n  return next;\n}\n\nexport interface OrbitalConfigPanelProps {\n  schema: string | OrbitalSchema;\n  exposedTiers?: string[];\n  position?: 'right' | 'bottom';\n  onSchemaChange?: (schema: OrbitalSchema) => void;\n}\n\nexport function OrbitalConfigPanel({\n  schema,\n  exposedTiers,\n  position = 'right',\n  onSchemaChange,\n}: OrbitalConfigPanelProps): React.ReactElement | null {\n  const parsed = useMemo(() => parseSchema(schema), [schema]);\n  const target = useMemo(() => findConfigTrait(parsed), [parsed]);\n  const [values, setValues] = useState<Record<string, TraitConfigValue>>({});\n\n  if (!target) return null;\n\n  const sortedConfig: DeclaredTraitConfig = Object.fromEntries(\n    Object.entries(target.config).sort(([a], [b]) => a.localeCompare(b)),\n  );\n\n  const handleChange = (field: string, value: TraitConfigValue): void => {\n    setValues((prev) => ({ ...prev, [field]: value }));\n    const nextSchema = applyConfigOverride(parsed, field, value);\n    onSchemaChange?.(nextSchema);\n  };\n\n  const handleReset = (): void => {\n    setValues({});\n    onSchemaChange?.(parsed);\n  };\n\n  const isHorizontal = position === 'bottom';\n\n  return (\n    <Box\n      className={`${\n        isHorizontal ? 'w-full border-t' : 'h-full w-80 flex-shrink-0 border-l'\n      } border-border bg-card p-3 overflow-y-auto`}\n    >\n      <Stack direction=\"vertical\" gap=\"sm\">\n        <Typography variant=\"caption\" weight=\"bold\" color=\"muted\">\n          Controls\n        </Typography>\n        <PropertyInspector\n          title={target.name}\n          config={sortedConfig}\n          values={values}\n          onChange={handleChange}\n          onReset={handleReset}\n          tiers={exposedTiers}\n        />\n      </Stack>\n    </Box>\n  );\n}\n\nOrbitalConfigPanel.displayName = 'OrbitalConfigPanel';\n","'use client';\n\n/**\n * `<AlmadarApp />` — renders an orbital schema in the customer's React tree.\n *\n * Thin facade over `@almadar/ui`'s `OrbPreview` (server-backed) and\n * `BrowserPlayground` (in-browser mock server). The `mode` prop picks the\n * runtime path:\n *   - `static`: pure OrbPreview with `mockData`\n *   - `mock`  : BrowserPlayground (in-browser server, faker-seeded)\n *   - `server`: OrbPreview with `serverUrl`\n *\n * Lazy-imports the heavy runtime bundle so the SDK is import-cheap in Next.js\n * server components; the actual render happens client-side under a Suspense\n * boundary. CSS is imported as a side-effect at module load.\n */\n\nimport { lazy, Suspense, useEffect, useMemo, useState } from 'react';\nimport type { AlmadarAppProps } from '../types';\nimport type { OrbitalSchema } from '@almadar/core';\nimport { OrbitalConfigPanel } from './OrbitalConfigPanel';\n// Required global styles. Customers who self-manage Tailwind can import from\n// the (forthcoming) `@almadar/sdk/react/no-css` entry instead.\nimport '@almadar/ui/index.css';\n\nconst OrbPreviewLazy = lazy(async () => {\n  const mod = await import('@almadar/ui/runtime');\n  return { default: mod.OrbPreview };\n});\n\nconst BrowserPlaygroundLazy = lazy(async () => {\n  const mod = await import('@almadar/ui/runtime');\n  return { default: mod.BrowserPlayground };\n});\n\nfunction parseSchema(schema: string | OrbitalSchema): OrbitalSchema {\n  if (typeof schema === 'string') {\n    return JSON.parse(schema) as OrbitalSchema;\n  }\n  return schema;\n}\n\nexport function AlmadarApp(props: AlmadarAppProps) {\n  const mode = props.mode ?? 'static';\n  const parsedSchema = useMemo(() => parseSchema(props.schema), [props.schema]);\n  const [controlledSchema, setControlledSchema] = useState<OrbitalSchema>(parsedSchema);\n\n  // Reset controlled schema when the incoming schema changes.\n  useEffect(() => {\n    setControlledSchema(parsedSchema);\n  }, [parsedSchema]);\n\n  const effectiveSchema = props.exposedTiers && mode !== 'server' ? controlledSchema : parsedSchema;\n  const showControls = props.exposedTiers && props.exposedTiers.length > 0 && mode !== 'server';\n\n  const preview = mode === 'mock' ? (\n    <BrowserPlaygroundLazy\n      schema={effectiveSchema}\n      mode=\"mock\"\n      initialPagePath={props.initialPagePath}\n      height={props.height}\n      className={props.className}\n    />\n  ) : (\n    <OrbPreviewLazy\n      schema={effectiveSchema}\n      mockData={props.data}\n      serverUrl={props.serverUrl}\n      initialPagePath={props.initialPagePath}\n      height={props.height}\n      className={props.className}\n    />\n  );\n\n  if (!showControls) {\n    return (\n      <Suspense fallback={null}>\n        {preview}\n      </Suspense>\n    );\n  }\n\n  const isBottom = props.controlsPosition === 'bottom';\n\n  return (\n    <Suspense fallback={null}>\n      <div\n        className={`flex ${isBottom ? 'flex-col' : 'flex-row'} w-full h-full`}\n        style={{ height: props.height }}\n      >\n        <div className=\"flex-1 min-w-0\">\n          {preview}\n        </div>\n        <OrbitalConfigPanel\n          schema={parsedSchema}\n          exposedTiers={props.exposedTiers}\n          position={props.controlsPosition}\n          onSchemaChange={setControlledSchema}\n        />\n      </div>\n    </Suspense>\n  );\n}\n\nAlmadarApp.displayName = 'AlmadarApp';\n"]}

package/dist/{types-D-q0c5Yt.d.ts → types-C6RJADoY.d.ts}

@@ -102,6 +102,24 @@ interface AlmadarAppProps {
     initialPagePath?: string;
     height?: string;
     className?: string;
+    /**
+     * Tiers of config knobs to surface as auto-derived controls. When provided,
+     * a control rail is rendered next to the app. Omit to hide controls.
+     * Common values: `['presentation']`, `['presentation', 'domain']`.
+     */
+    exposedTiers?: string[];
+    /** Where to render the auto-derived controls rail. Default: 'right'. */
+    controlsPosition?: 'right' | 'bottom';
+}
+/**
+ * Props for `<OrbitalConfigPanel />` — low-level control rail used by
+ * `<AlmadarApp />` when `exposedTiers` is set.
+ */
+interface OrbitalConfigPanelProps {
+    schema: string | OrbitalSchema;
+    exposedTiers?: string[];
+    position?: 'right' | 'bottom';
+    onSchemaChange?: (schema: OrbitalSchema) => void;
 }
 
-export type { AlmadarAppProps as A, CompileOptions as C, EditSchemaPatch as E, GenerateOptions as G, AlmadarClientOptions as a, ApiErrorBody as b, AsyncJobHandle as c, CompileResult as d, GenerateResult as e };
+export type { AlmadarAppProps as A, CompileOptions as C, EditSchemaPatch as E, GenerateOptions as G, OrbitalConfigPanelProps as O, AlmadarClientOptions as a, ApiErrorBody as b, AsyncJobHandle as c, CompileResult as d, GenerateResult as e };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/sdk",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Almadar SDK — embed agent-generated orbital schemas in your React app. AlmadarApp component + AlmadarClient HTTP client.",
   "type": "module",
   "main": "./dist/index.js",
@@ -37,10 +37,18 @@
     "README.md",
     "LICENSE"
   ],
+  "scripts": {
+    "build": "tsup",
+    "build:watch": "tsup --watch",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest --run",
+    "prepublishOnly": "pnpm run build"
+  },
   "dependencies": {
     "@almadar/core": "^10.11.0",
     "@almadar/runtime": "^6.17.0",
-    "@almadar/ui": "^5.76.7"
+    "@almadar/ui": "^5.79.0"
   },
   "peerDependencies": {
     "react": ">=18.0.0",
@@ -48,6 +56,7 @@
   },
   "devDependencies": {
     "@almadar/eslint-plugin": ">=2.7.0",
+    "@testing-library/dom": "^10.4.0",
     "@testing-library/react": "^16.1.0",
     "@types/express": "^4.17.21",
     "@types/react": "^18.3.12",
@@ -71,12 +80,5 @@
     "type": "git",
     "url": "https://github.com/almadar-io/almadar-sdk.git"
   },
-  "license": "BSL-1.1",
-  "scripts": {
-    "build": "tsup",
-    "build:watch": "tsup --watch",
-    "lint": "eslint src/",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest --run"
-  }
-}
+  "license": "BSL-1.1"
+}