nucleus-core-ts 0.9.802 → 0.9.804

package/dist/fe/components/IntegrationsPage/components/ConnectionSwitcher.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The chosen connection, as one line instead of a column.
+ *
+ * The panel used to keep the connection list as a permanent rail, so the work
+ * happened in what was left — and the work is itself a list beside an editor.
+ * Three columns inside an admin page that already has a nav is how a form ends
+ * up past the right edge of the screen with the page scrolling sideways.
+ *
+ * A connection is CHOSEN once and then worked in. Once it is chosen the rail
+ * has nothing left to say that this line does not, so the rail goes and the
+ * whole width goes to the step.
+ */
+export declare function ConnectionSwitcher(): import("react/jsx-runtime").JSX.Element | null;

package/dist/fe/components/IntegrationsPage/components/ConnectionSwitcher.js

@@ -0,0 +1,51 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from '../../../utils/cn';
+import { useIntegrationsStore } from '../store';
+import { useLabels } from '../text/context';
+import { integrationsPageTheme as theme } from '../theme';
+/**
+ * The chosen connection, as one line instead of a column.
+ *
+ * The panel used to keep the connection list as a permanent rail, so the work
+ * happened in what was left — and the work is itself a list beside an editor.
+ * Three columns inside an admin page that already has a nav is how a form ends
+ * up past the right edge of the screen with the page scrolling sideways.
+ *
+ * A connection is CHOSEN once and then worked in. Once it is chosen the rail
+ * has nothing left to say that this line does not, so the rail goes and the
+ * whole width goes to the step.
+ */ export function ConnectionSwitcher() {
+    const store = useIntegrationsStore();
+    const labels = useLabels();
+    const source = store.sources.find((candidate)=>candidate.id === store.selectedSourceId);
+    if (!source) return null;
+    return /*#__PURE__*/ _jsxs("div", {
+        className: cn('flex flex-wrap items-center justify-between gap-3 rounded-2xl border border-slate-200/80 bg-white px-4 py-3 dark:border-slate-800 dark:bg-slate-900'),
+        children: [
+            /*#__PURE__*/ _jsxs("div", {
+                className: "flex min-w-0 flex-col",
+                children: [
+                    /*#__PURE__*/ _jsx("span", {
+                        className: cn(theme.field.label, 'text-slate-400 dark:text-slate-500'),
+                        children: labels.connections.heading
+                    }),
+                    /*#__PURE__*/ _jsx("span", {
+                        className: "truncate font-semibold text-base text-slate-900 dark:text-slate-100",
+                        children: source.name
+                    }),
+                    /*#__PURE__*/ _jsx("span", {
+                        className: cn(theme.list.itemMeta, 'mt-0.5'),
+                        children: source.baseUrl
+                    })
+                ]
+            }),
+            /*#__PURE__*/ _jsx("button", {
+                className: theme.button.secondary,
+                onClick: ()=>store.selectSource(null),
+                type: "button",
+                children: labels.connections.change
+            })
+        ]
+    });
+}

package/dist/fe/components/IntegrationsPage/components/EndpointFormFields.js

@@ -1,6 +1,7 @@
 'use client';
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { cn } from '../../../utils/cn';
+import { useLabels } from '../text/context';
 import { integrationsPageTheme } from '../theme';
 import { describedBy } from './formSupport';
 import { Field } from './Primitives';
@@ -18,15 +19,16 @@ const METHODS = [
     'DELETE'
 ];
 export function EndpointFormFields({ draft, disabled, errors, onChange }) {
+    const labels = useLabels();
     return /*#__PURE__*/ _jsxs(_Fragment, {
         children: [
             /*#__PURE__*/ _jsxs("div", {
                 className: "grid grid-cols-1 gap-3 sm:grid-cols-2",
                 children: [
                     /*#__PURE__*/ _jsx(Field, {
-                        hint: "Groups the endpoints of one API.",
+                        hint: labels.endpoints.tagHint,
                         htmlFor: "endpoint-tag",
-                        label: "Tag",
+                        label: labels.endpoints.tag,
                         children: /*#__PURE__*/ _jsx("input", {
                             "aria-describedby": "endpoint-tag-hint",
                             className: theme.field.input,
@@ -35,14 +37,14 @@ export function EndpointFormFields({ draft, disabled, errors, onChange }) {
                             onChange: (event)=>onChange({
                                     tag: event.target.value
                                 }),
-                            placeholder: "directory",
+                            placeholder: labels.endpoints.tagPlaceholder,
                             type: "text",
                             value: draft.tag
                         })
                     }),
                     /*#__PURE__*/ _jsx(Field, {
                         htmlFor: "endpoint-name",
-                        label: "Name",
+                        label: labels.endpoints.name,
                         children: /*#__PURE__*/ _jsx("input", {
                             className: theme.field.input,
                             disabled: disabled,
@@ -50,7 +52,7 @@ export function EndpointFormFields({ draft, disabled, errors, onChange }) {
                             onChange: (event)=>onChange({
                                     name: event.target.value
                                 }),
-                            placeholder: "List people",
+                            placeholder: labels.endpoints.namePlaceholder,
                             type: "text",
                             value: draft.name
                         })
@@ -64,7 +66,7 @@ export function EndpointFormFields({ draft, disabled, errors, onChange }) {
                         className: "sm:w-32",
                         children: /*#__PURE__*/ _jsx(Field, {
                             htmlFor: "endpoint-method",
-                            label: "Method",
+                            label: labels.endpoints.method,
                             children: /*#__PURE__*/ _jsx("select", {
                                 className: theme.field.input,
                                 disabled: disabled,
@@ -87,9 +89,9 @@ export function EndpointFormFields({ draft, disabled, errors, onChange }) {
                     /*#__PURE__*/ _jsx("div", {
                         className: "min-w-0 flex-1",
                         children: /*#__PURE__*/ _jsx(Field, {
-                            hint: "{brace} and :colon path parameters are supported — parameter bindings supply their values.",
+                            hint: labels.endpoints.pathHint,
                             htmlFor: "endpoint-path",
-                            label: "Path",
+                            label: labels.endpoints.path,
                             children: /*#__PURE__*/ _jsx("input", {
                                 "aria-describedby": "endpoint-path-hint",
                                 className: theme.field.input,
@@ -98,7 +100,7 @@ export function EndpointFormFields({ draft, disabled, errors, onChange }) {
                                 onChange: (event)=>onChange({
                                         path: event.target.value
                                     }),
-                                placeholder: "/v1/people/{id}",
+                                placeholder: labels.endpoints.pathPlaceholder,
                                 type: "text",
                                 value: draft.path
                             })
@@ -107,9 +109,9 @@ export function EndpointFormFields({ draft, disabled, errors, onChange }) {
                 ]
             }),
             /*#__PURE__*/ _jsx(Field, {
-                hint: "Dotted path to the array of records. Leave it empty when the array is the response root.",
+                hint: labels.endpoints.rootPathHint,
                 htmlFor: "endpoint-root",
-                label: "Response root path",
+                label: labels.endpoints.rootPath,
                 children: /*#__PURE__*/ _jsx("input", {
                     "aria-describedby": "endpoint-root-hint",
                     className: theme.field.input,
@@ -118,16 +120,16 @@ export function EndpointFormFields({ draft, disabled, errors, onChange }) {
                     onChange: (event)=>onChange({
                             responseRootPath: event.target.value
                         }),
-                    placeholder: "data.items",
+                    placeholder: labels.endpoints.rootPathPlaceholder,
                     type: "text",
                     value: draft.responseRootPath
                 })
             }),
             /*#__PURE__*/ _jsx(Field, {
                 error: errors?.queryParams,
-                hint: "Sent with every call, as JSON. A parameter bound below overrides the same name here.",
+                hint: labels.endpoints.queryParamsHint,
                 htmlFor: "endpoint-query",
-                label: "Fixed query parameters",
+                label: labels.endpoints.queryParams,
                 children: /*#__PURE__*/ _jsx("textarea", {
                     "aria-describedby": describedBy('endpoint-query', true, Boolean(errors?.queryParams)),
                     className: cn(theme.field.input, 'h-auto min-h-16 py-2 font-mono text-xs'),
@@ -143,9 +145,9 @@ export function EndpointFormFields({ draft, disabled, errors, onChange }) {
             }),
             draft.method === 'GET' ? null : /*#__PURE__*/ _jsx(Field, {
                 error: errors?.requestBody,
-                hint: "The JSON body sent with this call. Some list endpoints are a POST whose body decides what comes back.",
+                hint: labels.endpoints.requestBodyHint,
                 htmlFor: "endpoint-body",
-                label: "Request body",
+                label: labels.endpoints.requestBody,
                 children: /*#__PURE__*/ _jsx("textarea", {
                     "aria-describedby": describedBy('endpoint-body', true, Boolean(errors?.requestBody)),
                     className: cn(theme.field.input, 'h-auto min-h-20 py-2 font-mono text-xs'),
@@ -161,7 +163,7 @@ export function EndpointFormFields({ draft, disabled, errors, onChange }) {
             }),
             /*#__PURE__*/ _jsx(Field, {
                 htmlFor: "endpoint-description",
-                label: "Description",
+                label: labels.endpoints.description,
                 children: /*#__PURE__*/ _jsx("textarea", {
                     className: cn(theme.field.input, 'h-auto min-h-20 py-2'),
                     disabled: disabled,
@@ -169,7 +171,7 @@ export function EndpointFormFields({ draft, disabled, errors, onChange }) {
                     onChange: (event)=>onChange({
                             description: event.target.value
                         }),
-                    placeholder: "What this call returns, in one line",
+                    placeholder: labels.endpoints.descriptionPlaceholder,
                     rows: 3,
                     value: draft.description
                 })
@@ -190,7 +192,7 @@ export function EndpointFormFields({ draft, disabled, errors, onChange }) {
                     }),
                     /*#__PURE__*/ _jsx("span", {
                         className: theme.field.label,
-                        children: "Enabled — a disabled endpoint is never called"
+                        children: labels.endpoints.enabled
                     })
                 ]
             })

package/dist/fe/components/IntegrationsPage/components/EndpointList.js

@@ -3,6 +3,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect, useEffectEvent, useState } from 'react';
 import { cn } from '../../../utils/cn';
 import { useIntegrationsStore } from '../store';
+import { useLabels } from '../text/context';
 import { integrationsPageTheme } from '../theme';
 import { Badge, Field, Notice } from './Primitives';
 import { ListSkeleton } from './Skeletons';
@@ -25,6 +26,7 @@ const METHOD_TONE = {
     DELETE: 'danger'
 };
 export function EndpointList({ sourceId, actions, onNewEndpoint, onSelect, reloadToken = 0 }) {
+    const labels = useLabels();
     const store = useIntegrationsStore();
     const search = store.endpointsSearch;
     const selectedId = store.selectedEndpointId;
@@ -91,7 +93,7 @@ export function EndpointList({ sourceId, actions, onNewEndpoint, onSelect, reloa
     };
     const firstLoad = list.loading && list.items.length === 0;
     return /*#__PURE__*/ _jsxs("section", {
-        "aria-label": "Endpoints",
+        "aria-label": labels.endpoints.heading,
         className: theme.layout.aside,
         children: [
             /*#__PURE__*/ _jsxs("div", {
@@ -101,7 +103,7 @@ export function EndpointList({ sourceId, actions, onNewEndpoint, onSelect, reloa
                         children: [
                             /*#__PURE__*/ _jsx("h2", {
                                 className: theme.header.title,
-                                children: "Endpoints"
+                                children: labels.endpoints.heading
                             }),
                             /*#__PURE__*/ _jsx("p", {
                                 className: theme.header.subtitle,
@@ -122,12 +124,12 @@ export function EndpointList({ sourceId, actions, onNewEndpoint, onSelect, reloa
             }),
             /*#__PURE__*/ _jsx(Field, {
                 htmlFor: "endpoint-search",
-                label: "Search",
+                label: labels.endpoints.searchLabel,
                 children: /*#__PURE__*/ _jsx("input", {
                     className: theme.field.input,
                     id: "endpoint-search",
                     onChange: (event)=>setTerm(event.target.value),
-                    placeholder: "Tag, name or path",
+                    placeholder: labels.endpoints.searchPlaceholder,
                     type: "search",
                     value: term
                 })
@@ -136,7 +138,7 @@ export function EndpointList({ sourceId, actions, onNewEndpoint, onSelect, reloa
                 rows: 6
             }) : null,
             list.error ? /*#__PURE__*/ _jsxs(Notice, {
-                title: "This list could not be loaded",
+                title: labels.endpoints.loadFailed,
                 tone: "danger",
                 children: [
                     list.error,
@@ -198,7 +200,7 @@ export function EndpointList({ sourceId, actions, onNewEndpoint, onSelect, reloa
             }),
             list.loading && list.items.length > 0 ? /*#__PURE__*/ _jsx("p", {
                 className: theme.field.hint,
-                children: "Loading more…"
+                children: labels.endpoints.loadingMore
             }) : null
         ]
     });

package/dist/fe/components/IntegrationsPage/components/EndpointSample.js

@@ -2,6 +2,7 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useRef, useState } from 'react';
 import { useIntegrationsStore } from '../store';
+import { useLabels } from '../text/context';
 import { integrationsPageTheme } from '../theme';
 import { Badge, CodeBlock, Field, Notice, Stat } from './Primitives';
 import { pathParamNames } from './pathParams';
@@ -15,6 +16,7 @@ import { CardSkeleton, StatGridSkeleton } from './Skeletons';
  * their own block here rather than being folded into a generic "no data".
  */ const theme = integrationsPageTheme;
 export function EndpointSample({ endpoint, actions }) {
+    const labels = useLabels();
     const store = useIntegrationsStore();
     const [values, setValues] = useState({});
     // Kept in step with the render so an in-flight reply can ask what is selected
@@ -53,14 +55,14 @@ export function EndpointSample({ endpoint, actions }) {
                 children: [
                     /*#__PURE__*/ _jsx("h3", {
                         className: theme.card.title,
-                        children: "Response sample"
+                        children: labels.endpoints.sampleHeading
                     }),
                     /*#__PURE__*/ _jsx("button", {
                         className: theme.button.secondary,
                         disabled: store.sampling || unfilled > 0,
                         onClick: run,
                         type: "button",
-                        children: store.sampling ? 'Sampling…' : 'Send one request'
+                        children: store.sampling ? 'Sampling…' : '{labels.endpoints.sampleSend}'
                     })
                 ]
             }),
@@ -72,7 +74,7 @@ export function EndpointSample({ endpoint, actions }) {
                         children: [
                             /*#__PURE__*/ _jsx("legend", {
                                 className: theme.field.label,
-                                children: "Example path parameter values"
+                                children: labels.endpoints.samplePathValues
                             }),
                             /*#__PURE__*/ _jsx("p", {
                                 className: theme.field.hint,
@@ -90,7 +92,7 @@ export function EndpointSample({ endpoint, actions }) {
                                                         ...previous,
                                                         [name]: event.target.value
                                                     })),
-                                            placeholder: "example value",
+                                            placeholder: labels.endpoints.samplePlaceholder,
                                             type: "text",
                                             value: values[name] ?? ''
                                         })
@@ -110,32 +112,32 @@ export function EndpointSample({ endpoint, actions }) {
                                 className: theme.stat.grid,
                                 children: [
                                     /*#__PURE__*/ _jsx(Stat, {
-                                        label: "HTTP status",
+                                        label: labels.endpoints.sampleStatus,
                                         tone: sample.ok ? 'success' : 'danger',
                                         value: sample.status
                                     }),
                                     /*#__PURE__*/ _jsx(Stat, {
-                                        label: "Records read",
+                                        label: labels.endpoints.sampleRecords,
                                         tone: sample.recordCount === 0 ? 'warning' : undefined,
                                         value: sample.recordCount
                                     }),
                                     /*#__PURE__*/ _jsx(Stat, {
-                                        label: "Fields",
+                                        label: labels.endpoints.sampleFields,
                                         value: sample.fields.length
                                     }),
                                     /*#__PURE__*/ _jsx(Stat, {
-                                        label: "Body keys",
+                                        label: labels.endpoints.sampleBodyKeys,
                                         value: sample.bodyKeys.length
                                     })
                                 ]
                             }),
                             sample.error ? /*#__PURE__*/ _jsx(Notice, {
-                                title: "The source answered with an error",
+                                title: labels.endpoints.sampleFailed,
                                 tone: "danger",
                                 children: sample.error
                             }) : null,
                             sample.recordCount === 0 ? /*#__PURE__*/ _jsxs(Notice, {
-                                title: "The request succeeded and no records were read",
+                                title: labels.endpoints.sampleNoRecords,
                                 tone: "warning",
                                 children: [
                                     /*#__PURE__*/ _jsx("p", {
@@ -166,7 +168,7 @@ export function EndpointSample({ endpoint, actions }) {
                                 children: [
                                     /*#__PURE__*/ _jsx("h4", {
                                         className: theme.field.label,
-                                        children: "Fields on the first record"
+                                        children: labels.endpoints.sampleFirstRecordFields
                                     }),
                                     /*#__PURE__*/ _jsx("ul", {
                                         className: "flex flex-wrap gap-1.5",
@@ -184,7 +186,7 @@ export function EndpointSample({ endpoint, actions }) {
                                 children: [
                                     /*#__PURE__*/ _jsx("h4", {
                                         className: theme.field.label,
-                                        children: "Sample records"
+                                        children: labels.endpoints.sampleRows
                                     }),
                                     /*#__PURE__*/ _jsx(CodeBlock, {
                                         children: JSON.stringify(sample.sample, null, 2)

package/dist/fe/components/IntegrationsPage/components/EndpointsTab.js

@@ -2,6 +2,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect, useEffectEvent, useState } from 'react';
 import { useIntegrationsStore } from '../store';
+import { useLabels } from '../text/context';
 import { integrationsPageTheme } from '../theme';
 import { EndpointForm } from './EndpointForm';
 import { EndpointList } from './EndpointList';
@@ -14,6 +15,7 @@ import { EndpointSample } from './EndpointSample';
  * is what makes switching selection a fresh form rather than a merged one.
  */ const theme = integrationsPageTheme;
 export function EndpointsTab({ actions }) {
+    const labels = useLabels();
     const store = useIntegrationsStore();
     const sourceId = store.selectedSourceId;
     const [selected, setSelected] = useState(null);
@@ -60,7 +62,7 @@ export function EndpointsTab({ actions }) {
     if (!sourceId) {
         return /*#__PURE__*/ _jsx("p", {
             className: theme.list.empty,
-            children: "Select a connection to see its endpoints."
+            children: labels.endpoints.selectConnection
         });
     }
     // Guarded against the store: the selection is the store's, and a record left

package/dist/fe/components/IntegrationsPage/components/IntegrationsPage.js

@@ -10,6 +10,7 @@ import { IntegrationsLabelsProvider } from '../text/context';
 import { integrationsPageTheme } from '../theme';
 import { ConnectionList } from './ConnectionList';
 import { ConnectionSettingsTab } from './ConnectionSettingsTab';
+import { ConnectionSwitcher } from './ConnectionSwitcher';
 import { ConnectionTabs, connectionTabId, connectionTabPanelId } from './ConnectionTabs';
 import { EndpointsTab } from './EndpointsTab';
 import { MappingsTab } from './MappingsTab';
@@ -185,68 +186,62 @@ export function IntegrationsPage({ title = 'Integrations', subtitle = 'Connect a
                         ]
                     }) : null
                 }),
-                /*#__PURE__*/ _jsxs("div", {
-                    className: theme.layout.split,
+                /*#__PURE__*/ _jsx("div", {
+                    className: "flex min-w-0 flex-col gap-4 sm:gap-5",
                     ref: contentRef,
-                    children: [
-                        /*#__PURE__*/ _jsx("aside", {
-                            "aria-label": labels.connections.heading,
-                            className: theme.layout.aside,
-                            children: /*#__PURE__*/ _jsx(ConnectionList, {
-                                actions: actions,
-                                reloadToken: sourcesReloadToken
-                            })
-                        }),
-                        /*#__PURE__*/ _jsx("section", {
-                            "aria-label": "Connection detail",
-                            className: theme.layout.main,
-                            children: hasConnection ? /*#__PURE__*/ _jsxs(_Fragment, {
-                                children: [
-                                    /*#__PURE__*/ _jsx(ConnectionTabs, {
-                                        onChange: changeTab,
-                                        steps: steps,
-                                        value: tab
-                                    }),
-                                    /*#__PURE__*/ _jsxs("section", {
-                                        "aria-labelledby": connectionTabId(tab),
-                                        className: theme.layout.main,
-                                        id: connectionTabPanelId(tab),
-                                        role: "tabpanel",
-                                        children: [
-                                            tab === 'connection' ? /*#__PURE__*/ _jsx(ConnectionSettingsTab, {
-                                                actions: actions,
-                                                onSaved: handleSourceSaved
-                                            }) : null,
-                                            tab === 'endpoints' ? /*#__PURE__*/ _jsx(EndpointsTab, {
-                                                actions: actions
-                                            }) : null,
-                                            tab === 'mappings' ? /*#__PURE__*/ _jsx(MappingsTab, {
-                                                actions: actions
-                                            }) : null,
-                                            tab === 'runs' ? /*#__PURE__*/ _jsx(RunsTab, {
-                                                actions: actions
-                                            }) : null
-                                        ]
-                                    })
-                                ]
-                            }) : // Not a dead end. With nothing selected the only useful thing on this
-                            // screen is creating a connection, so that is what it shows — the
-                            // previous message told an operator to select from a list that is
-                            // empty on a fresh install, with no way to add the first one.
-                            /*#__PURE__*/ _jsxs(_Fragment, {
+                    children: hasConnection ? /*#__PURE__*/ _jsxs(_Fragment, {
+                        children: [
+                            /*#__PURE__*/ _jsx(ConnectionSwitcher, {}),
+                            /*#__PURE__*/ _jsx(ConnectionTabs, {
+                                onChange: changeTab,
+                                steps: steps,
+                                value: tab
+                            }),
+                            /*#__PURE__*/ _jsxs("section", {
+                                "aria-labelledby": connectionTabId(tab),
+                                className: theme.layout.main,
+                                id: connectionTabPanelId(tab),
+                                role: "tabpanel",
                                 children: [
-                                    /*#__PURE__*/ _jsx("p", {
-                                        className: theme.list.empty,
-                                        children: "Select a connection on the left, or set up a new one here."
-                                    }),
-                                    /*#__PURE__*/ _jsx(ConnectionSettingsTab, {
+                                    tab === 'connection' ? /*#__PURE__*/ _jsx(ConnectionSettingsTab, {
                                         actions: actions,
                                         onSaved: handleSourceSaved
-                                    })
+                                    }) : null,
+                                    tab === 'endpoints' ? /*#__PURE__*/ _jsx(EndpointsTab, {
+                                        actions: actions
+                                    }) : null,
+                                    tab === 'mappings' ? /*#__PURE__*/ _jsx(MappingsTab, {
+                                        actions: actions
+                                    }) : null,
+                                    tab === 'runs' ? /*#__PURE__*/ _jsx(RunsTab, {
+                                        actions: actions,
+                                        onSubscribeProgress: onSubscribeProgress
+                                    }) : null
                                 ]
                             })
-                        })
-                    ]
+                        ]
+                    }) : // Nothing chosen yet, so choosing IS the screen: the list and the
+                    // blank form side by side, both with room.
+                    /*#__PURE__*/ _jsxs("div", {
+                        className: theme.layout.split,
+                        children: [
+                            /*#__PURE__*/ _jsx("aside", {
+                                "aria-label": labels.connections.heading,
+                                className: theme.layout.aside,
+                                children: /*#__PURE__*/ _jsx(ConnectionList, {
+                                    actions: actions,
+                                    reloadToken: sourcesReloadToken
+                                })
+                            }),
+                            /*#__PURE__*/ _jsx("section", {
+                                className: theme.layout.main,
+                                children: /*#__PURE__*/ _jsx(ConnectionSettingsTab, {
+                                    actions: actions,
+                                    onSaved: handleSourceSaved
+                                })
+                            })
+                        ]
+                    })
                 })
             ]
         })

package/dist/fe/components/IntegrationsPage/components/PaginationFields.js

@@ -1,5 +1,6 @@
 'use client';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useLabels } from '../text/context';
 import { integrationsPageTheme } from '../theme';
 import { Field, Notice } from './Primitives';
 /**
@@ -141,6 +142,7 @@ const SIZE_LABEL = 'Records per request';
     ]
 };
 export function PaginationFields({ idPrefix, value, disabled, onChange }) {
+    const labels = useLabels();
     const write = (spec, entered)=>{
         const next = {
             ...value
@@ -161,14 +163,14 @@ export function PaginationFields({ idPrefix, value, disabled, onChange }) {
         className: "flex flex-col gap-3",
         children: [
             /*#__PURE__*/ _jsx(Notice, {
-                title: "The pagination profile is chosen, not guessed",
+                title: labels.endpoints.paginationTitle,
                 tone: "warning",
                 children: "Nothing here is detected for you. Pick the wrong style and the import still succeeds — it reads the first page and never asks for the rest. In a destructive write mode the records it never saw count as missing, so the run deletes or deactivates them."
             }),
             /*#__PURE__*/ _jsx(Field, {
-                hint: "Match this to how the API documents its own list endpoints.",
+                hint: labels.endpoints.paginationHint,
                 htmlFor: `${idPrefix}-kind`,
-                label: "Pagination style",
+                label: labels.endpoints.paginationStyle,
                 children: /*#__PURE__*/ _jsx("select", {
                     "aria-describedby": `${idPrefix}-kind-hint`,
                     className: theme.field.input,

package/dist/fe/components/IntegrationsPage/components/ParamBindingRow.js

@@ -1,10 +1,12 @@
 'use client';
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useId } from 'react';
+import { useLabels } from '../text/context';
 import { integrationsPageTheme as theme } from '../theme';
 import { endpointLabel } from './formSupport';
 import { Field } from './Primitives';
 export function ParamBindingRow({ binding, onChange, onRemove, siblings, entities, disabled }) {
+    const labels = useLabels();
     const rowId = useId();
     const changeSource = (from)=>{
         if (from === 'static') onChange({
@@ -40,15 +42,15 @@ export function ParamBindingRow({ binding, onChange, onRemove, siblings, entitie
                     children: [
                         /*#__PURE__*/ _jsx("option", {
                             value: "static",
-                            children: "A fixed value"
+                            children: labels.endpoints.bindStatic
                         }),
                         /*#__PURE__*/ _jsx("option", {
                             value: "endpoint",
-                            children: "A field of another endpoint"
+                            children: labels.endpoints.bindEndpoint
                         }),
                         /*#__PURE__*/ _jsx("option", {
                             value: "entity",
-                            children: "A column of one of our tables"
+                            children: labels.endpoints.bindEntity
                         })
                     ]
                 })
@@ -67,16 +69,17 @@ export function ParamBindingRow({ binding, onChange, onRemove, siblings, entitie
                 disabled: disabled,
                 onClick: onRemove,
                 type: "button",
-                children: "Remove"
+                children: labels.common.remove
             })
         ]
     });
 }
 /** The half of a row that depends on which source was chosen. */ function ParamBindingValueFields({ binding, onChange, siblings, entities, disabled, rowId }) {
+    const labels = useLabels();
     if (binding.from === 'static') {
         return /*#__PURE__*/ _jsx(Field, {
             htmlFor: `${rowId}-value`,
-            label: "Value",
+            label: labels.endpoints.bindValue,
             children: /*#__PURE__*/ _jsx("input", {
                 className: theme.field.input,
                 disabled: disabled,
@@ -85,7 +88,7 @@ export function ParamBindingRow({ binding, onChange, onRemove, siblings, entitie
                         ...binding,
                         value: event.target.value
                     }),
-                placeholder: "e.g. ACTIVE",
+                placeholder: labels.endpoints.bindValuePlaceholder,
                 value: binding.value
             })
         });
@@ -94,9 +97,9 @@ export function ParamBindingRow({ binding, onChange, onRemove, siblings, entitie
         return /*#__PURE__*/ _jsxs(_Fragment, {
             children: [
                 /*#__PURE__*/ _jsx(Field, {
-                    hint: "Fetched first; this endpoint is then called once per record it returns.",
+                    hint: labels.endpoints.bindEndpointHint,
                     htmlFor: `${rowId}-endpoint`,
-                    label: "From endpoint",
+                    label: labels.endpoints.bindEndpoint,
                     children: /*#__PURE__*/ _jsx("select", {
                         className: theme.field.input,
                         disabled: disabled,
@@ -114,7 +117,7 @@ export function ParamBindingRow({ binding, onChange, onRemove, siblings, entitie
                 }),
                 /*#__PURE__*/ _jsx(Field, {
                     htmlFor: `${rowId}-field`,
-                    label: "Field",
+                    label: labels.endpoints.bindField,
                     children: /*#__PURE__*/ _jsx("input", {
                         className: theme.field.input,
                         disabled: disabled,
@@ -123,7 +126,7 @@ export function ParamBindingRow({ binding, onChange, onRemove, siblings, entitie
                                 ...binding,
                                 field: event.target.value
                             }),
-                        placeholder: "e.g. name",
+                        placeholder: labels.endpoints.bindFieldPlaceholder,
                         value: binding.field
                     })
                 })
@@ -135,7 +138,7 @@ export function ParamBindingRow({ binding, onChange, onRemove, siblings, entitie
         children: [
             /*#__PURE__*/ _jsx(Field, {
                 htmlFor: `${rowId}-entity`,
-                label: "From table",
+                label: labels.endpoints.bindTable,
                 children: /*#__PURE__*/ _jsx("select", {
                     className: theme.field.input,
                     disabled: disabled,
@@ -154,7 +157,7 @@ export function ParamBindingRow({ binding, onChange, onRemove, siblings, entitie
             }),
             /*#__PURE__*/ _jsx(Field, {
                 htmlFor: `${rowId}-column`,
-                label: "Column",
+                label: labels.endpoints.bindColumn,
                 children: /*#__PURE__*/ _jsxs("select", {
                     className: theme.field.input,
                     disabled: disabled,
@@ -167,7 +170,7 @@ export function ParamBindingRow({ binding, onChange, onRemove, siblings, entitie
                     children: [
                         /*#__PURE__*/ _jsx("option", {
                             value: "",
-                            children: "Choose a column…"
+                            children: labels.endpoints.bindColumnEmpty
                         }),
                         (selected?.fields ?? []).map((field)=>/*#__PURE__*/ _jsx("option", {
                                 value: field,

package/dist/fe/components/IntegrationsPage/components/ParamBindingRows.js

@@ -1,6 +1,7 @@
 'use client';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useId } from 'react';
+import { useLabels } from '../text/context';
 import { integrationsPageTheme as theme } from '../theme';
 import { ParamBindingRow } from './ParamBindingRow';
 import { Notice } from './Primitives';
@@ -20,6 +21,7 @@ import { Notice } from './Primitives';
  *  - a column of one of our own tables, for "fetch the detail of everything I
  *    already have".
  */ export function ParamBindingRows({ required, value, onChange, siblings, entities, disabled = false }) {
+    const labels = useLabels();
     const groupId = useId();
     const bound = new Set(value.map((binding)=>binding.param));
     const unbound = required.filter((name)=>!bound.has(name));
@@ -65,7 +67,7 @@ import { Notice } from './Primitives';
                         ]
                     }) : null,
                     unbound.length > 0 ? /*#__PURE__*/ _jsxs(Notice, {
-                        title: "These parameters have no value yet",
+                        title: labels.endpoints.bindingsTitle,
                         tone: "warning",
                         children: [
                             unbound.join(', '),

package/dist/fe/components/IntegrationsPage/text/index.d.ts

@@ -56,6 +56,8 @@ export type IntegrationsLabels = {
         loadFailed: string;
         retry: string;
         off: string;
+        /** Returns to the chooser once a connection is being worked in. */
+        change: string;
     };
     runs: {
         /** The one-line summary above the buttons. */
@@ -80,6 +82,75 @@ export type IntegrationsLabels = {
         skipped: string;
         dedupKey: string;
     };
+    /** Step two: the calls this connection can make. */
+    endpoints: {
+        heading: string;
+        countOne: string;
+        countMany: (n: number) => string;
+        searchLabel: string;
+        searchPlaceholder: string;
+        create: string;
+        empty: string;
+        emptySearch: (term: string) => string;
+        loadFailed: string;
+        loadingMore: string;
+        selectConnection: string;
+        editTitle: string;
+        newTitle: string;
+        tag: string;
+        tagHint: string;
+        tagPlaceholder: string;
+        name: string;
+        namePlaceholder: string;
+        method: string;
+        path: string;
+        pathHint: string;
+        pathPlaceholder: string;
+        rootPath: string;
+        rootPathHint: string;
+        rootPathPlaceholder: string;
+        queryParams: string;
+        queryParamsHint: string;
+        requestBody: string;
+        requestBodyHint: string;
+        description: string;
+        descriptionPlaceholder: string;
+        enabled: string;
+        save: string;
+        paginationTitle: string;
+        paginationBody: string;
+        paginationStyle: string;
+        paginationHint: string;
+        bindingsTitle: string;
+        bindingsUnbound: (names: string) => string;
+        bindingsNone: string;
+        bindFrom: string;
+        bindStatic: string;
+        bindEndpoint: string;
+        bindEntity: string;
+        bindValue: string;
+        bindValuePlaceholder: string;
+        bindEndpointHint: string;
+        bindField: string;
+        bindFieldPlaceholder: string;
+        bindTable: string;
+        bindColumn: string;
+        bindColumnEmpty: string;
+        sampleHeading: string;
+        sampleSend: string;
+        sampleNothingYet: string;
+        samplePathValues: string;
+        samplePathValuesHint: string;
+        samplePlaceholder: string;
+        sampleStatus: string;
+        sampleRecords: string;
+        sampleFields: string;
+        sampleBodyKeys: string;
+        sampleFailed: string;
+        sampleNoRecords: string;
+        sampleFirstRecordFields: string;
+        sampleRows: string;
+    };
     /** The connection form — the first screen anyone meets. */
     connectionForm: {
         sectionLabel: string;
@@ -118,6 +189,7 @@ export type IntegrationsLabels = {
         saving: string;
         somethingWentWrong: string;
         dismiss: string;
+        remove: string;
     };
 };
 /** What every app gets before it says otherwise. */

package/dist/fe/components/IntegrationsPage/text/index.js

@@ -50,7 +50,8 @@
         emptySearch: (term)=>`No connection matches “${term}”. Clear the search to see them all.`,
         loadFailed: 'This list could not be loaded',
         retry: 'Try again',
-        off: 'Off'
+        off: 'Off',
+        change: 'Change'
     },
     runs: {
         summary: (target, writeMode, missing)=>`Writes into ${target} · ${writeMode} · missing rows: ${missing}`,
@@ -74,6 +75,74 @@
         skipped: 'Skipped',
         dedupKey: 'Dedup key'
     },
+    endpoints: {
+        heading: 'Calls',
+        countOne: '1 call',
+        countMany: (n)=>`${n} calls`,
+        searchLabel: 'Search',
+        searchPlaceholder: 'Tag, name or path',
+        create: 'New call',
+        empty: 'No calls yet. A call is one request this connection can make — a method, a path, and where the records sit in the answer.',
+        emptySearch: (term)=>`No call matches “${term}”.`,
+        loadFailed: 'This list could not be loaded',
+        loadingMore: 'Loading more…',
+        selectConnection: 'Select a connection to see its calls.',
+        editTitle: 'Edit call',
+        newTitle: 'New call',
+        tag: 'Tag',
+        tagHint: 'Groups the calls of one API.',
+        tagPlaceholder: 'directory',
+        name: 'Name',
+        namePlaceholder: 'List people',
+        method: 'Method',
+        path: 'Path',
+        pathHint: '{brace} and :colon path parameters are supported — parameter bindings supply their values.',
+        pathPlaceholder: '/v1/people/{id}',
+        rootPath: 'Where the records sit',
+        rootPathHint: 'Dotted path to the array of records. Leave it empty when the array is the response root.',
+        rootPathPlaceholder: 'data.items',
+        queryParams: 'Fixed query parameters',
+        queryParamsHint: 'Sent with every call, as JSON. A parameter bound below overrides the same name here.',
+        requestBody: 'Request body',
+        requestBodyHint: 'The JSON body sent with this call. Some list endpoints are a POST whose body decides what comes back.',
+        description: 'Description',
+        descriptionPlaceholder: 'What this call returns, in one line',
+        enabled: 'Enabled — a disabled call is never made',
+        save: 'Save call',
+        paginationTitle: 'The paging style is chosen, not guessed',
+        paginationBody: 'Nothing here is detected for you. Pick the wrong style and the import still succeeds — it reads the first page and never asks for the rest. In a destructive write mode the records it never saw count as missing, so the run deletes or deactivates them.',
+        paginationStyle: 'Paging style',
+        paginationHint: 'Match this to how the API documents its own list endpoints.',
+        bindingsTitle: 'Parameter values',
+        bindingsUnbound: (names)=>`${names} — an import cannot run until every one of them is bound. Add a binding for each below.`,
+        bindingsNone: 'This call takes no parameters. Add a {name} token to its path if it needs one.',
+        bindFrom: 'Value from',
+        bindStatic: 'A fixed value',
+        bindEndpoint: 'A field of another call',
+        bindEntity: 'A column of one of our tables',
+        bindValue: 'Value',
+        bindValuePlaceholder: 'e.g. ACTIVE',
+        bindEndpointHint: 'Fetched first; this call is then made once per record it returns.',
+        bindField: 'Field',
+        bindFieldPlaceholder: 'e.g. name',
+        bindTable: 'From table',
+        bindColumn: 'Column',
+        bindColumnEmpty: 'Choose a column…',
+        sampleHeading: 'Try it',
+        sampleSend: 'Send one request',
+        sampleNothingYet: 'Nothing has been tried yet. One request is sent, read-only, and the shape it comes back with is what the field mapping is built from.',
+        samplePathValues: 'Example parameter values',
+        samplePathValuesHint: 'Used for this one request only. During a run each parameter takes its value from the binding configured for it.',
+        samplePlaceholder: 'example value',
+        sampleStatus: 'HTTP status',
+        sampleRecords: 'Records read',
+        sampleFields: 'Fields',
+        sampleBodyKeys: 'Body keys',
+        sampleFailed: 'The source answered with an error',
+        sampleNoRecords: 'The request succeeded and no records were read',
+        sampleFirstRecordFields: 'Fields on the first record',
+        sampleRows: 'Sample records'
+    },
     connectionForm: {
         sectionLabel: 'Connection details',
         name: 'Name',
@@ -110,7 +179,8 @@
         deleting: 'Deleting…',
         saving: 'Saving…',
         somethingWentWrong: 'Something went wrong',
-        dismiss: 'Dismiss error'
+        dismiss: 'Dismiss error',
+        remove: 'Remove'
     }
 };
 /**

package/dist/fe/types/index.d.ts

@@ -1,4 +1,5 @@
 import type { ReactNode } from 'react';
+import type { FilterCondition, SortCondition } from '../../src/types';
 export type SortDirection = 'asc' | 'desc' | null;
 export interface QueryParams {
     page?: number;
@@ -10,15 +11,19 @@ export interface QueryParams {
     filters?: string;
     with?: string;
 }
-export interface FilterCondition {
-    field: string;
-    operator: 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'like' | 'ilike' | 'in' | 'notIn' | 'isNull' | 'isNotNull';
-    value: unknown;
-}
-export interface SortCondition {
-    field: string;
-    direction: 'asc' | 'desc';
-}
+/**
+ * Re-exported from the server's own definition, not redeclared.
+ *
+ * This file used to carry a NARROWER copy: `field` was required and the
+ * operator list stopped before `arrayOverlaps`, `arrayContains`, `arrayEmpty`,
+ * `or` and `and`. So a query the backend accepts — an `or` group, or a filter
+ * over an array column — was a type error on the client, and the two drifted
+ * every time an operator was added on one side only.
+ *
+ * Types flow from the server outward. A second definition of the same contract
+ * is a second thing to keep right.
+ */
+export type { FilterCondition, FilterOperator, SortCondition } from '../../src/types';
 export interface PaginationMeta {
     page: number;
     limit: number;
@@ -229,4 +234,3 @@ export interface UseNucleusEntityReturn<T extends Record<string, unknown>> {
     setCurrentPage: (page: number) => void;
     refetch: () => void;
 }
-export {};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "nucleus-core-ts",
-	"version": "0.9.802",
+	"version": "0.9.804",
 	"description": "Production-ready, enterprise-grade TypeScript framework for building multi-tenant APIs",
 	"author": "Hidayet Can Özcan <hidayetcan@gmail.com>",
 	"license": "SEE LICENSE IN LICENSE",

package/scripts/generate-schema.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'bun:test'
-import { selectEmittedTables } from './generate-schema'
+import { generateColumnCode, selectEmittedTables } from './generate-schema'
 
 const table = (table_name: string) => ({ table_name })
 
@@ -76,3 +76,34 @@ describe('selectEmittedTables', () => {
     expect(selectEmittedTables([], sets({}))).toEqual([])
   })
 })
+
+/**
+ * `numeric` and `decimal` are STRING-mode columns in drizzle — Postgres numeric
+ * is arbitrary precision and a JS number cannot carry it. The generator emitted
+ * `.default(0)` for them, producing a schema that ran and did not typecheck.
+ * Nobody reads a generated file, so only `tsc` ever objected — and the project's
+ * typecheck did not cover the folder it landed in.
+ */
+describe('numeric defaults are quoted', () => {
+  const emit = (col: Record<string, unknown>) =>
+    generateColumnCode(col as never, [], 'widgets')
+
+  it('quotes a numeric default, because the column reads as a string', () => {
+    expect(emit({ name: 'position_x', type: 'numeric', notNull: true, default: 0 })).toContain(
+      ".default('0')"
+    )
+    expect(emit({ name: 'rate', type: 'decimal', default: 0.4 })).toContain(".default('0.4')")
+  })
+
+  it('leaves a real number column alone', () => {
+    expect(emit({ name: 'count', type: 'integer', default: 0 })).toContain('.default(0)')
+    expect(emit({ name: 'ratio', type: 'real', default: 1.5 })).toContain('.default(1.5)')
+  })
+
+  it('quotes it with a precision too, where the column carries options', () => {
+    const code = emit({ name: 'lat', type: 'numeric', precision: 10, scale: 8, default: 0 })
+
+    expect(code).toContain('precision: 10')
+    expect(code).toContain(".default('0')")
+  })
+})

package/scripts/generate-schema.ts

@@ -108,6 +108,18 @@ const BASE_COLUMNS: Column[] = [
   { name: 'updated_by', type: 'uuid' },
 ]
 
+/**
+ * Columns drizzle reads and writes as STRINGS.
+ *
+ * Postgres `numeric` is arbitrary precision, so drizzle refuses to round-trip
+ * it through a JS number and types the column as a string. A default therefore
+ * has to be quoted — `.default(0)` compiles to a schema that RUNS and does not
+ * typecheck, which is exactly the kind of defect a generated file hides.
+ */
+function isNumericType(type: string): boolean {
+  return type === 'numeric' || type === 'decimal'
+}
+
 const TYPE_MAP: Record<string, string> = {
   integer: 'integer',
   smallint: 'smallint',
@@ -200,7 +212,7 @@ export function selectEmittedTables<T extends { table_name: string }>(
   )
 }
 
-function generateColumnCode(col: Column, allTables: string[], currentTable?: string): string {
+export function generateColumnCode(col: Column, allTables: string[], currentTable?: string): string {
   const drizzleType = TYPE_MAP[col.type] || 'text'
   let code = ''
 
@@ -255,7 +267,12 @@ function generateColumnCode(col: Column, allTables: string[], currentTable?: str
     } else if (typeof col.default === 'boolean') {
       code += `.default(${col.default})`
     } else if (typeof col.default === 'number') {
-      code += `.default(${col.default})`
+      // `numeric`/`decimal` are STRING-mode columns in drizzle — Postgres numeric
+      // is arbitrary precision and a JS number cannot carry it — so a numeric
+      // default has to be quoted. Emitting the bare number produced a schema
+      // that ran fine and failed `tsc`, which is how it survived: the file is
+      // generated, so nobody reads it, and only a typecheck ever objected.
+      code += isNumericType(col.type) ? `.default('${col.default}')` : `.default(${col.default})`
     } else if (Array.isArray(col.default)) {
       code += `.default(sql\`'{}'\`)`
     } else if (typeof col.default === 'object') {