@surveystudio/node-registery 1.0.1 → 1.0.2

package/README.md

@@ -16,6 +16,18 @@ Use `/logic` for Worker, export, and server runtimes. It is intentionally React-
 
 Use `/runner` and `/builder` only in React runtimes. React is a peer dependency and is not bundled.
 
+## Logic Pipeline
+
+Every node logic module should expose the same pure, Worker-safe pipeline:
+
+```ts
+const value = logicRegistry.plainText.normalizeValue(rawAnswer, node.data, context);
+const validation = logicRegistry.plainText.validate(value, node.data, context);
+const columns = logicRegistry.plainText.extractValue(value, node.data, context);
+```
+
+Runner APIs should persist and queue normalized values. Export/projection APIs should read normalized values through `extractValue`.
+
 ## Current Status
 
 Migrated nodes:

package/dist/builder.d.mts

@@ -1,6 +1,7 @@
-import { J as JsonValue } from './types-Bsz6x6iU.mjs';
-export { B as BuilderRegistry, h as CompleteBuilderRegistry, i as NodeBuilder, j as NodeBuilderProps, k as NodeCanvasProps, l as NodeManifest, P as PropertyField, m as PropertyFieldType, Q as QuestionNodeDefinition, S as SelectOption, n as defineBuilderRegistry, b as defineQuestionNode } from './types-Bsz6x6iU.mjs';
-import { P as PlainTextData } from './types-HCD7-TAw.mjs';
+export { B as BuilderRegistry, c as CompleteBuilderRegistry, e as NodeBuilder, f as NodeBuilderProps, g as NodeCanvasProps, Q as QuestionNodeDefinition, h as defineBuilderRegistry, d as defineQuestionNode } from './types-BpvjaHAP.mjs';
+import { J as JsonValue } from './coreTypes-D-1hYIe5.mjs';
+export { f as NodeManifest, P as PropertyField, g as PropertyFieldType, S as SelectOption } from './coreTypes-D-1hYIe5.mjs';
+import { P as PlainTextData } from './types-D78Zx0gX.mjs';
 import 'react';
 
 declare const plainTextBuilder: {

package/dist/{types-Bsz6x6iU.d.mts → coreTypes-D-1hYIe5.d.mts}

@@ -1,5 +1,3 @@
-import { ReactNode, ComponentType } from 'react';
-
 declare const QUESTION_NODE_TYPES: readonly ["textInput", "numberInput", "emailInput", "dateInput", "multiInput", "zipCodeInput", "singleChoice", "multipleChoice", "dropdown", "ranking", "cascadingChoice", "matrixChoice", "rating", "slider", "consent", "captcha", "image", "video", "audio", "plainText", "emojiRating"];
 declare const FLOW_NODE_TYPES: readonly ["start", "end", "branch", "validation"];
 type QuestionNodeType = (typeof QUESTION_NODE_TYPES)[number];
@@ -43,6 +41,14 @@ interface ValidationResult {
     readonly valid: boolean;
     readonly error?: string;
 }
+interface NodeLogicContext<TType extends SurveyNodeType = SurveyNodeType> {
+    readonly nodeId: string;
+    readonly nodeType: TType;
+    readonly answerKey?: string;
+}
+interface ValidationContext<TType extends SurveyNodeType = SurveyNodeType> extends NodeLogicContext<TType> {
+    readonly mode?: "LIVE" | "TEST";
+}
 interface ExtractedValue {
     readonly questionId?: string;
     readonly columnKey?: string;
@@ -56,9 +62,7 @@ interface ExtractedValue {
     readonly objectValue?: Readonly<Record<string, JsonValue>>;
     readonly metadata?: Readonly<Record<string, JsonValue>>;
 }
-interface ExtractionContext<TType extends SurveyNodeType = SurveyNodeType> {
-    readonly nodeId: string;
-    readonly nodeType: TType;
+interface ExtractionContext<TType extends SurveyNodeType = SurveyNodeType> extends NodeLogicContext<TType> {
     readonly questionLabel?: string;
 }
 interface NodeLogic<TType extends SurveyNodeType = SurveyNodeType, TData extends NodeData = NodeData, TValue extends NodeValue = NodeValue> {
@@ -66,60 +70,16 @@ interface NodeLogic<TType extends SurveyNodeType = SurveyNodeType, TData extends
     readonly dataType: DataType;
     readonly defaultData: Readonly<TData>;
     readonly defaultValue?: TValue;
-    validate(value: TValue, nodeData: Readonly<TData>): ValidationResult;
+    normalizeValue(rawValue: unknown, nodeData: Readonly<TData>, context: NodeLogicContext<TType>): TValue;
+    validate(value: TValue, nodeData: Readonly<TData>, context: ValidationContext<TType>): ValidationResult;
     extractValue(value: TValue, nodeData: Readonly<TData>, context: ExtractionContext<TType>): readonly ExtractedValue[];
 }
-interface NodeRunnerProps<TData extends NodeData = NodeData, TValue extends NodeValue = NodeValue> {
-    readonly data: Readonly<TData>;
-    readonly value: TValue;
-    readonly onChange: (newValue: TValue) => void;
-    readonly onNext?: () => void;
-    readonly error?: string;
-    readonly isActive?: boolean;
-}
-interface NodeRunner<TType extends SurveyNodeType = SurveyNodeType, TData extends NodeData = NodeData, TValue extends NodeValue = NodeValue> {
-    readonly type: TType;
-    readonly Component?: ComponentType<NodeRunnerProps<TData, TValue>>;
-}
-interface NodeBuilderProps<TData extends NodeData = NodeData> {
-    readonly data: Readonly<TData>;
-    readonly onChange: (newData: TData) => void;
-}
-interface NodeCanvasProps<TData extends NodeData = NodeData> {
-    readonly id: string;
-    readonly type: SurveyNodeType;
-    readonly data: Readonly<TData>;
-    readonly selected?: boolean;
-}
-interface NodeBuilder<TType extends SurveyNodeType = SurveyNodeType, TData extends NodeData = NodeData> {
-    readonly type: TType;
-    readonly label: string;
-    readonly icon?: ReactNode;
-    readonly SettingsComponent?: ComponentType<NodeBuilderProps<TData>>;
-    readonly CanvasComponent?: ComponentType<NodeCanvasProps<TData>>;
-}
-interface QuestionNodeDefinition<TType extends QuestionNodeType = QuestionNodeType, TData extends NodeData = NodeData, TValue extends NodeValue = NodeValue> {
-    readonly manifest: NodeManifest<TType, TData>;
-    readonly logic: NodeLogic<TType, TData, TValue>;
-    readonly builder: NodeBuilder<TType, TData>;
-    readonly runner: NodeRunner<TType, TData, TValue>;
-}
 type CompleteLogicRegistry<TType extends QuestionNodeType = QuestionNodeType> = Readonly<Record<TType, NodeLogic<TType, NodeData, NodeValue>>>;
-type CompleteBuilderRegistry<TType extends QuestionNodeType = QuestionNodeType> = Readonly<Record<TType, NodeBuilder<TType, NodeData>>>;
-type CompleteRunnerRegistry<TType extends QuestionNodeType = QuestionNodeType> = Readonly<Record<TType, NodeRunner<TType, NodeData, NodeValue>>>;
 type LogicRegistry<TType extends SurveyNodeType = SurveyNodeType> = Readonly<Partial<{
     [K in TType]: NodeLogic<K, NodeData, NodeValue>;
 }>>;
-type BuilderRegistry<TType extends SurveyNodeType = SurveyNodeType> = Readonly<Partial<{
-    [K in TType]: NodeBuilder<K, NodeData>;
-}>>;
-type RunnerRegistry<TType extends SurveyNodeType = SurveyNodeType> = Readonly<Partial<{
-    [K in TType]: NodeRunner<K, NodeData, NodeValue>;
-}>>;
-declare function defineQuestionNode<const TType extends QuestionNodeType, TData extends NodeData, TValue extends NodeValue>(definition: QuestionNodeDefinition<TType, TData, TValue>): QuestionNodeDefinition<TType, TData, TValue>;
 type RegistryKeySet = Readonly<Partial<Record<SurveyNodeType, unknown>>>;
 declare function defineLogicRegistry<const TRegistry extends RegistryKeySet>(registry: TRegistry): TRegistry;
-declare function defineBuilderRegistry<const TRegistry extends RegistryKeySet>(registry: TRegistry): TRegistry;
-declare function defineRunnerRegistry<const TRegistry extends RegistryKeySet>(registry: TRegistry): TRegistry;
+declare function createInitialData<TData extends NodeData>(manifest: NodeManifest<SurveyNodeType, TData>): TData;
 
-export { type BuilderRegistry as B, type CompleteLogicRegistry as C, type DataType as D, type ExtractedValue as E, type JsonValue as J, type LogicRegistry as L, type NodeLogic as N, type PropertyField as P, type QuestionNodeDefinition as Q, type RunnerRegistry as R, type SelectOption as S, type ValidationResult as V, type ExtractionContext as a, defineQuestionNode as b, type CompleteRunnerRegistry as c, defineLogicRegistry as d, type NodeRunner as e, type NodeRunnerProps as f, defineRunnerRegistry as g, type CompleteBuilderRegistry as h, type NodeBuilder as i, type NodeBuilderProps as j, type NodeCanvasProps as k, type NodeManifest as l, type PropertyFieldType as m, defineBuilderRegistry as n, type NodeData as o };
+export { type CompleteLogicRegistry as C, type DataType as D, type ExtractedValue as E, type JsonValue as J, type LogicRegistry as L, type NodeLogic as N, type PropertyField as P, type QuestionNodeType as Q, type SelectOption as S, type ValidationContext as V, type ExtractionContext as a, type NodeLogicContext as b, type ValidationResult as c, createInitialData as d, defineLogicRegistry as e, type NodeManifest as f, type PropertyFieldType as g, type NodeData as h, type SurveyNodeType as i, type NodeValue as j };

package/dist/logic.d.mts

@@ -1,6 +1,5 @@
-import { P as PlainTextData, a as PlainTextValue } from './types-HCD7-TAw.mjs';
-export { C as CompleteLogicRegistry, D as DataType, E as ExtractedValue, a as ExtractionContext, L as LogicRegistry, N as NodeLogic, Q as QuestionNodeDefinition, V as ValidationResult, d as defineLogicRegistry, b as defineQuestionNode } from './types-Bsz6x6iU.mjs';
-import 'react';
+import { P as PlainTextData, a as PlainTextValue } from './types-D78Zx0gX.mjs';
+export { C as CompleteLogicRegistry, D as DataType, E as ExtractedValue, a as ExtractionContext, L as LogicRegistry, N as NodeLogic, b as NodeLogicContext, V as ValidationContext, c as ValidationResult, d as createInitialData, e as defineLogicRegistry } from './coreTypes-D-1hYIe5.mjs';
 
 declare const plainTextLogic: {
     type: "plainText";
@@ -9,6 +8,7 @@ declare const plainTextLogic: {
     defaultValue: {
         viewed: false;
     };
+    normalizeValue: (value: unknown) => PlainTextValue;
     validate: () => {
         valid: true;
     };
@@ -27,6 +27,7 @@ declare const logicRegistry: {
         defaultValue: {
             viewed: false;
         };
+        normalizeValue: (value: unknown) => PlainTextValue;
         validate: () => {
             valid: true;
         };

package/dist/logic.mjs

@@ -1,10 +1,10 @@
-// src/types.ts
-function defineQuestionNode(definition) {
-  return definition;
-}
+// src/coreTypes.ts
 function defineLogicRegistry(registry) {
   return registry;
 }
+function createInitialData(manifest) {
+  return { ...manifest.defaultData };
+}
 
 // src/nodes/plainText/manifest.ts
 var plainTextDefaultData = {
@@ -45,17 +45,24 @@ var plainTextManifest = {
 };
 
 // src/nodes/plainText/logic.ts
+var normalizePlainTextValue = (value) => {
+  if (!value || typeof value !== "object") {
+    return { viewed: false };
+  }
+  return { viewed: Boolean(value.viewed) };
+};
 var plainTextLogic = {
   type: "plainText",
   dataType: "none",
   defaultData: plainTextDefaultData,
   defaultValue: { viewed: false },
+  normalizeValue: (value) => normalizePlainTextValue(value),
   validate: () => ({ valid: true }),
   extractValue: (value) => [
     {
       columnKey: "viewed",
       columnLabel: "Viewed",
-      booleanValue: Boolean(value?.viewed)
+      booleanValue: Boolean(value.viewed)
     }
   ]
 };
@@ -65,8 +72,8 @@ var logicRegistry = defineLogicRegistry({
   plainText: plainTextLogic
 });
 export {
+  createInitialData,
   defineLogicRegistry,
-  defineQuestionNode,
   logicRegistry,
   plainTextLogic
 };

package/dist/runner.d.mts

@@ -1,5 +1,6 @@
-export { c as CompleteRunnerRegistry, e as NodeRunner, f as NodeRunnerProps, Q as QuestionNodeDefinition, R as RunnerRegistry, b as defineQuestionNode, g as defineRunnerRegistry } from './types-Bsz6x6iU.mjs';
+export { C as CompleteRunnerRegistry, N as NodeRunner, a as NodeRunnerProps, Q as QuestionNodeDefinition, R as RunnerRegistry, d as defineQuestionNode, b as defineRunnerRegistry } from './types-BpvjaHAP.mjs';
 import 'react';
+import './coreTypes-D-1hYIe5.mjs';
 
 declare const plainTextRunner: {
     type: "plainText";

package/dist/types-BpvjaHAP.d.mts

@@ -0,0 +1,51 @@
+import { ComponentType, ReactNode } from 'react';
+import { Q as QuestionNodeType, i as SurveyNodeType, h as NodeData, j as NodeValue, f as NodeManifest, N as NodeLogic } from './coreTypes-D-1hYIe5.mjs';
+
+interface NodeRunnerProps<TData extends NodeData = NodeData, TValue extends NodeValue = NodeValue> {
+    readonly data: Readonly<TData>;
+    readonly value: TValue;
+    readonly onChange: (newValue: TValue) => void;
+    readonly onNext?: () => void;
+    readonly error?: string;
+    readonly isActive?: boolean;
+}
+interface NodeRunner<TType extends SurveyNodeType = SurveyNodeType, TData extends NodeData = NodeData, TValue extends NodeValue = NodeValue> {
+    readonly type: TType;
+    readonly Component?: ComponentType<NodeRunnerProps<TData, TValue>>;
+}
+interface NodeBuilderProps<TData extends NodeData = NodeData> {
+    readonly data: Readonly<TData>;
+    readonly onChange: (newData: TData) => void;
+}
+interface NodeCanvasProps<TData extends NodeData = NodeData> {
+    readonly id: string;
+    readonly type: SurveyNodeType;
+    readonly data: Readonly<TData>;
+    readonly selected?: boolean;
+}
+interface NodeBuilder<TType extends SurveyNodeType = SurveyNodeType, TData extends NodeData = NodeData> {
+    readonly type: TType;
+    readonly label: string;
+    readonly icon?: ReactNode;
+    readonly SettingsComponent?: ComponentType<NodeBuilderProps<TData>>;
+    readonly CanvasComponent?: ComponentType<NodeCanvasProps<TData>>;
+}
+interface QuestionNodeDefinition<TType extends QuestionNodeType = QuestionNodeType, TData extends NodeData = NodeData, TValue extends NodeValue = NodeValue> {
+    readonly manifest: NodeManifest<TType, TData>;
+    readonly logic: NodeLogic<TType, TData, TValue>;
+    readonly builder: NodeBuilder<TType, TData>;
+    readonly runner: NodeRunner<TType, TData, TValue>;
+}
+type CompleteBuilderRegistry<TType extends QuestionNodeType = QuestionNodeType> = Readonly<Record<TType, NodeBuilder<TType, NodeData>>>;
+type CompleteRunnerRegistry<TType extends QuestionNodeType = QuestionNodeType> = Readonly<Record<TType, NodeRunner<TType, NodeData, NodeValue>>>;
+type BuilderRegistry<TType extends SurveyNodeType = SurveyNodeType> = Readonly<Partial<{
+    [K in TType]: NodeBuilder<K, NodeData>;
+}>>;
+type RunnerRegistry<TType extends SurveyNodeType = SurveyNodeType> = Readonly<Partial<{
+    [K in TType]: NodeRunner<K, NodeData, NodeValue>;
+}>>;
+declare function defineQuestionNode<const TType extends QuestionNodeType, TData extends NodeData, TValue extends NodeValue>(definition: QuestionNodeDefinition<TType, TData, TValue>): QuestionNodeDefinition<TType, TData, TValue>;
+declare function defineBuilderRegistry<const TRegistry extends Readonly<Partial<Record<SurveyNodeType, unknown>>>>(registry: TRegistry): TRegistry;
+declare function defineRunnerRegistry<const TRegistry extends Readonly<Partial<Record<SurveyNodeType, unknown>>>>(registry: TRegistry): TRegistry;
+
+export { type BuilderRegistry as B, type CompleteRunnerRegistry as C, type NodeRunner as N, type QuestionNodeDefinition as Q, type RunnerRegistry as R, type NodeRunnerProps as a, defineRunnerRegistry as b, type CompleteBuilderRegistry as c, defineQuestionNode as d, type NodeBuilder as e, type NodeBuilderProps as f, type NodeCanvasProps as g, defineBuilderRegistry as h };

package/dist/{types-HCD7-TAw.d.mts → types-D78Zx0gX.d.mts}

@@ -1,4 +1,4 @@
-import { o as NodeData, J as JsonValue } from './types-Bsz6x6iU.mjs';
+import { h as NodeData, J as JsonValue } from './coreTypes-D-1hYIe5.mjs';
 
 type PlainTextData = NodeData & {
     label: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@surveystudio/node-registery",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Typed survey question node registry with split builder, runner, and logic entrypoints.",
   "main": "./dist/logic.mjs",
   "types": "./dist/logic.d.mts",
@@ -46,7 +46,7 @@
     "react-dom": "^19.2.3"
   },
   "scripts": {
-    "test": "node --test test/*.test.mjs",
+    "test": "pnpm build && node --test test/*.test.mjs",
     "typecheck": "tsc --noEmit",
     "build": "tsup",
     "prepack": "pnpm build",