@pwfabric/runtime 0.0.0-stage → 1.0.0-rc.1

package/dist/surface/validation.js

@@ -0,0 +1,147 @@
+/**
+ * Block Props Validation
+ *
+ * Runtime validation of block props using injected Zod schemas.
+ * the legacy `blockSchemas` map is gone — production
+ * callers supply a schema map sourced from the install pipeline (per-atom
+ * `manifest.definition.props[*].jsonSchema` rebuilt into Zod). Without a
+ * schema map the validator runs in lenient mode and passes everything
+ * through.
+ *
+ * @module @pwfabric/runtime/surface/validation
+ */
+// ============================================================
+// VALIDATION FUNCTIONS
+// ============================================================
+/**
+ * Validate block props against the known Zod schema for the given block type.
+ *
+ * - Known block types are validated against the schema from @pwfabric/core.
+ * - Unknown block types pass through in lenient mode (default) and fail in strict mode.
+ * - On success, returns coerced data (with defaults applied by Zod).
+ */
+export function validateBlockProps(type, props, options = {}) {
+    const { strict = false, schemas } = options;
+    const schema = schemas?.[type];
+    if (!schema) {
+        if (strict) {
+            return {
+                valid: false,
+                errors: [`Unknown block type: ${type}`],
+            };
+        }
+        // Lenient mode: unknown / unsupplied types pass through
+        return { valid: true, errors: [] };
+    }
+    const result = schema.safeParse(props);
+    if (result.success) {
+        return {
+            valid: true,
+            errors: [],
+            coerced: result.data,
+        };
+    }
+    return {
+        valid: false,
+        errors: result.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`),
+    };
+}
+/**
+ * Validate all block props in a layout tree recursively.
+ *
+ * Returns a flat list of validation issues with path context.
+ */
+export function validateLayoutProps(layout, options = {}, path = 'root') {
+    const issues = [];
+    const result = validateBlockProps(layout.type, layout.props ?? {}, options);
+    if (!result.valid) {
+        issues.push({
+            path,
+            type: layout.type,
+            errors: result.errors,
+        });
+    }
+    if (layout.children) {
+        for (let i = 0; i < layout.children.length; i++) {
+            const child = layout.children[i];
+            if (child) {
+                const childIssues = validateLayoutProps(child, options, `${path}.children[${i}]`);
+                issues.push(...childIssues);
+            }
+        }
+    }
+    return issues;
+}
+function carriesTemplate(value, depth = 0) {
+    if (depth > 8)
+        return false;
+    if (typeof value === 'string')
+        return value.includes('{{');
+    if (Array.isArray(value))
+        return value.some((v) => carriesTemplate(v, depth + 1));
+    if (value && typeof value === 'object') {
+        return Object.values(value).some((v) => carriesTemplate(v, depth + 1));
+    }
+    return false;
+}
+/**
+ * The props of ONE block that its manifest does not allow.
+ *
+ * WHY: a prop the manifest does not declare was
+ * accepted silently. The schema check rebuilds each prop's JSON schema into a
+ * passthrough object, so a misspelt or invented prop (`tone` on a block that
+ * has none, `paddingY` where the block reads `padding`) validated clean and
+ * did nothing on screen. And a `{{ }}` template on a `bindable: false` prop was
+ * shown to the visitor as literal braces. Both are now named.
+ *
+ * @param specs the block's declared props; `undefined` (block not in the map)
+ *   yields nothing, because an unknown block type is a different finding.
+ */
+export function blockManifestPropFindings(type, props, specs, path = 'root') {
+    if (!specs || !props)
+        return [];
+    const byName = new Map(specs.map((s) => [s.name, s]));
+    const out = [];
+    for (const [prop, value] of Object.entries(props)) {
+        if (value === undefined)
+            continue;
+        const spec = byName.get(prop);
+        if (!spec) {
+            out.push({
+                path,
+                type,
+                prop,
+                code: 'UNKNOWN_PROP',
+                severity: 'warning',
+                message: `"${prop}" is not a prop of ${type}; the block ignores it.`,
+            });
+            continue;
+        }
+        if (spec.bindable === false && carriesTemplate(value)) {
+            out.push({
+                path,
+                type,
+                prop,
+                code: 'TEMPLATE_ON_UNBINDABLE',
+                severity: 'warning',
+                message: `"${prop}" on ${type} takes a literal value; its {{ }} template is shown as written.`,
+            });
+        }
+    }
+    return out;
+}
+/**
+ * Every manifest finding in a layout tree, with path context. Blocks whose
+ * type is not in `manifests` are skipped.
+ */
+export function manifestPropFindings(layout, manifests, path = 'root') {
+    const out = blockManifestPropFindings(layout.type, layout.props, manifests[layout.type], path);
+    if (layout.children) {
+        layout.children.forEach((child, i) => {
+            if (child)
+                out.push(...manifestPropFindings(child, manifests, `${path}.children[${i}]`));
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=validation.js.map

package/dist/surface/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/surface/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA6CH,+DAA+D;AAC/D,uBAAuB;AACvB,+DAA+D;AAE/D;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,KAA8B,EAC9B,UAAuC,EAAE;IAEzC,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAA;IAE3C,MAAM,MAAM,GAAG,OAAO,EAAE,CAAC,IAAI,CAAC,CAAA;IAE9B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,IAAI,MAAM,EAAE,CAAC;YACX,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE,CAAC,uBAAuB,IAAI,EAAE,CAAC;aACxC,CAAA;QACH,CAAC;QACD,wDAAwD;QACxD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;IACpC,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IAEtC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO;YACL,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,MAAM,CAAC,IAA+B;SAChD,CAAA;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAC7B,CAAC,CAAiD,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAC3F;KACF,CAAA;AACH,CAAC;AAqBD;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAkB,EAClB,UAAuC,EAAE,EACzC,IAAI,GAAG,MAAM;IAEb,MAAM,MAAM,GAAuB,EAAE,CAAA;IAErC,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,EAAE,OAAO,CAAC,CAAA;IAC3E,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC;YACV,IAAI;YACJ,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC,CAAA;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAChD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;YAChC,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,WAAW,GAAG,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,aAAa,CAAC,GAAG,CAAC,CAAA;gBACjF,MAAM,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAA;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAmCD,SAAS,eAAe,CAAC,KAAc,EAAE,KAAK,GAAG,CAAC;IAChD,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,KAAK,CAAA;IAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC1D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAA;IACjF,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,OAAO,MAAM,CAAC,MAAM,CAAC,KAAgC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAA;IACnG,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,yBAAyB,CACvC,IAAY,EACZ,KAA0C,EAC1C,KAA8C,EAC9C,IAAI,GAAG,MAAM;IAEb,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAA;IAC/B,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IACrD,MAAM,GAAG,GAA0B,EAAE,CAAA;IACrC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS;YAAE,SAAQ;QACjC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC7B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,GAAG,CAAC,IAAI,CAAC;gBACP,IAAI;gBACJ,IAAI;gBACJ,IAAI;gBACJ,IAAI,EAAE,cAAc;gBACpB,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,IAAI,IAAI,sBAAsB,IAAI,yBAAyB;aACrE,CAAC,CAAA;YACF,SAAQ;QACV,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;YACtD,GAAG,CAAC,IAAI,CAAC;gBACP,IAAI;gBACJ,IAAI;gBACJ,IAAI;gBACJ,IAAI,EAAE,wBAAwB;gBAC9B,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,IAAI,IAAI,QAAQ,IAAI,iEAAiE;aAC/F,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAkB,EAClB,SAAgC,EAChC,IAAI,GAAG,MAAM;IAEb,MAAM,GAAG,GAAG,yBAAyB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAA;IAC9F,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;YACnC,IAAI,KAAK;gBAAE,GAAG,CAAC,IAAI,CAAC,GAAG,oBAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC,CAAA;QAC1F,CAAC,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC","sourcesContent":["/**\n * Block Props Validation\n *\n * Runtime validation of block props using injected Zod schemas.\n * the legacy `blockSchemas` map is gone — production\n * callers supply a schema map sourced from the install pipeline (per-atom\n * `manifest.definition.props[*].jsonSchema` rebuilt into Zod). Without a\n * schema map the validator runs in lenient mode and passes everything\n * through.\n *\n * @module @pwfabric/runtime/surface/validation\n */\n\nimport type { ZodSchema } from 'zod'\n\n/** Map of block type → Zod schema. Supply via options to enable strict checks. */\nexport type BlockSchemaMap = Readonly<Record<string, ZodSchema>>\n\n// ============================================================\n// VALIDATION TYPES\n// ============================================================\n\n/**\n * Options for block props validation\n */\nexport interface BlockPropsValidationOptions {\n  /**\n   * When true, unknown block types cause validation failure.\n   * When false (default), unknown block types pass through.\n   */\n  readonly strict?: boolean\n  /**\n   * Per-block-type Zod schemas. the runtime no longer\n   * ships a built-in schema map — callers that want prop validation\n   * supply their own (typically rebuilt from\n   * each installed block manifest's `definition.props[*].jsonSchema`).\n   * Omitting the map yields lenient pass-through behaviour.\n   */\n  readonly schemas?: BlockSchemaMap\n  /**\n   * Per-block-type manifest props. When supplied, props a manifest\n   * does not declare and templates on `bindable: false` props are reported as\n   * WARNINGS (`manifestPropFindings`); they never fail validation.\n   */\n  readonly manifests?: BlockManifestPropsMap\n}\n\n/**\n * Result of validating block props against the schema\n */\nexport interface BlockPropsValidationResult {\n  readonly valid: boolean\n  readonly errors: readonly string[]\n  readonly coerced?: Record<string, unknown>\n}\n\n// ============================================================\n// VALIDATION FUNCTIONS\n// ============================================================\n\n/**\n * Validate block props against the known Zod schema for the given block type.\n *\n * - Known block types are validated against the schema from @pwfabric/core.\n * - Unknown block types pass through in lenient mode (default) and fail in strict mode.\n * - On success, returns coerced data (with defaults applied by Zod).\n */\nexport function validateBlockProps(\n  type: string,\n  props: Record<string, unknown>,\n  options: BlockPropsValidationOptions = {}\n): BlockPropsValidationResult {\n  const { strict = false, schemas } = options\n\n  const schema = schemas?.[type]\n\n  if (!schema) {\n    if (strict) {\n      return {\n        valid: false,\n        errors: [`Unknown block type: ${type}`],\n      }\n    }\n    // Lenient mode: unknown / unsupplied types pass through\n    return { valid: true, errors: [] }\n  }\n\n  const result = schema.safeParse(props)\n\n  if (result.success) {\n    return {\n      valid: true,\n      errors: [],\n      coerced: result.data as Record<string, unknown>,\n    }\n  }\n\n  return {\n    valid: false,\n    errors: result.error.issues.map(\n      (i: { path: (string | number)[]; message: string }) => `${i.path.join('.')}: ${i.message}`\n    ),\n  }\n}\n\n/**\n * Layout node shape for recursive validation.\n * Matches LayoutJSON structure without importing it to avoid circular deps.\n */\ninterface LayoutNode {\n  readonly type: string\n  readonly props?: Record<string, unknown>\n  readonly children?: readonly LayoutNode[]\n}\n\n/**\n * A single validation issue with path context\n */\nexport interface LayoutPropsIssue {\n  readonly path: string\n  readonly type: string\n  readonly errors: readonly string[]\n}\n\n/**\n * Validate all block props in a layout tree recursively.\n *\n * Returns a flat list of validation issues with path context.\n */\nexport function validateLayoutProps(\n  layout: LayoutNode,\n  options: BlockPropsValidationOptions = {},\n  path = 'root'\n): readonly LayoutPropsIssue[] {\n  const issues: LayoutPropsIssue[] = []\n\n  const result = validateBlockProps(layout.type, layout.props ?? {}, options)\n  if (!result.valid) {\n    issues.push({\n      path,\n      type: layout.type,\n      errors: result.errors,\n    })\n  }\n\n  if (layout.children) {\n    for (let i = 0; i < layout.children.length; i++) {\n      const child = layout.children[i]\n      if (child) {\n        const childIssues = validateLayoutProps(child, options, `${path}.children[${i}]`)\n        issues.push(...childIssues)\n      }\n    }\n  }\n\n  return issues\n}\n\n// ============================================================\n// PACK MANIFEST ENFORCEMENT\n// ============================================================\n\n/**\n * One prop a pack manifest declares: `manifest.definition.props[*]`. Only the\n * two fields the check reads; a full manifest entry passes as it is.\n */\nexport interface ManifestPropSpec {\n  readonly name: string\n  /** `false` = the prop takes a literal only; a `{{ }}` template is not resolved for it. */\n  readonly bindable?: boolean\n}\n\n/** Block type → the props its manifest declares. */\nexport type BlockManifestPropsMap = Readonly<Record<string, readonly ManifestPropSpec[]>>\n\nexport type ManifestPropFindingCode = 'UNKNOWN_PROP' | 'TEMPLATE_ON_UNBINDABLE'\n\n/**\n * A prop that does not match its block's manifest. Always a WARNING:\n * existing apps carry such props and must keep rendering; a caller\n * decides whether to show, count or (later) refuse them.\n */\nexport interface ManifestPropFinding {\n  readonly path: string\n  readonly type: string\n  readonly prop: string\n  readonly code: ManifestPropFindingCode\n  readonly severity: 'warning'\n  readonly message: string\n}\n\nfunction carriesTemplate(value: unknown, depth = 0): boolean {\n  if (depth > 8) return false\n  if (typeof value === 'string') return value.includes('{{')\n  if (Array.isArray(value)) return value.some((v) => carriesTemplate(v, depth + 1))\n  if (value && typeof value === 'object') {\n    return Object.values(value as Record<string, unknown>).some((v) => carriesTemplate(v, depth + 1))\n  }\n  return false\n}\n\n/**\n * The props of ONE block that its manifest does not allow.\n *\n * WHY: a prop the manifest does not declare was\n * accepted silently. The schema check rebuilds each prop's JSON schema into a\n * passthrough object, so a misspelt or invented prop (`tone` on a block that\n * has none, `paddingY` where the block reads `padding`) validated clean and\n * did nothing on screen. And a `{{ }}` template on a `bindable: false` prop was\n * shown to the visitor as literal braces. Both are now named.\n *\n * @param specs the block's declared props; `undefined` (block not in the map)\n *   yields nothing, because an unknown block type is a different finding.\n */\nexport function blockManifestPropFindings(\n  type: string,\n  props: Record<string, unknown> | undefined,\n  specs: readonly ManifestPropSpec[] | undefined,\n  path = 'root'\n): ManifestPropFinding[] {\n  if (!specs || !props) return []\n  const byName = new Map(specs.map((s) => [s.name, s]))\n  const out: ManifestPropFinding[] = []\n  for (const [prop, value] of Object.entries(props)) {\n    if (value === undefined) continue\n    const spec = byName.get(prop)\n    if (!spec) {\n      out.push({\n        path,\n        type,\n        prop,\n        code: 'UNKNOWN_PROP',\n        severity: 'warning',\n        message: `\"${prop}\" is not a prop of ${type}; the block ignores it.`,\n      })\n      continue\n    }\n    if (spec.bindable === false && carriesTemplate(value)) {\n      out.push({\n        path,\n        type,\n        prop,\n        code: 'TEMPLATE_ON_UNBINDABLE',\n        severity: 'warning',\n        message: `\"${prop}\" on ${type} takes a literal value; its {{ }} template is shown as written.`,\n      })\n    }\n  }\n  return out\n}\n\n/**\n * Every manifest finding in a layout tree, with path context. Blocks whose\n * type is not in `manifests` are skipped.\n */\nexport function manifestPropFindings(\n  layout: LayoutNode,\n  manifests: BlockManifestPropsMap,\n  path = 'root'\n): ManifestPropFinding[] {\n  const out = blockManifestPropFindings(layout.type, layout.props, manifests[layout.type], path)\n  if (layout.children) {\n    layout.children.forEach((child, i) => {\n      if (child) out.push(...manifestPropFindings(child, manifests, `${path}.children[${i}]`))\n    })\n  }\n  return out\n}\n"]}

package/dist/validator.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Contract Validator
+ *
+ * Runtime validation for contracts
+ *
+ * @module @pwfabric/runtime/validator
+ */
+import type { Contract, Capability, ValidationResult, ValidationError } from '@pwfabric/contracts';
+/**
+ * Contract validator interface
+ */
+export interface ContractValidator {
+    /**
+     * Validate input against a contract
+     */
+    validateInput<T>(contract: Contract<T, unknown>, data: unknown): ValidationResult<T>;
+    /**
+     * Validate output against a contract
+     */
+    validateOutput<T>(contract: Contract<unknown, T>, data: unknown): ValidationResult<T>;
+    /**
+     * Validate a capability's contract
+     */
+    validateCapability(capability: Capability): ValidationResult<void>;
+}
+/**
+ * Runtime contract validator
+ */
+export declare class RuntimeContractValidator implements ContractValidator {
+    validateInput<T>(contract: Contract<T, unknown>, data: unknown): ValidationResult<T>;
+    validateOutput<T>(contract: Contract<unknown, T>, data: unknown): ValidationResult<T>;
+    validateCapability(capability: Capability): ValidationResult<void>;
+}
+/**
+ * Create a contract validator
+ */
+export declare function createValidator(): ContractValidator;
+/**
+ * Validation result type guard
+ */
+export declare function isValidationSuccess<T>(result: ValidationResult<T>): result is {
+    success: true;
+    data: T;
+};
+/**
+ * Validation result type guard for errors
+ */
+export declare function isValidationFailure<T>(result: ValidationResult<T>): result is {
+    success: false;
+    error: ValidationError[];
+};
+/**
+ * Format validation errors as a string
+ */
+export declare function formatValidationErrors(errors: ValidationError[]): string;

package/dist/validator.js

@@ -0,0 +1,100 @@
+/**
+ * Contract Validator
+ *
+ * Runtime validation for contracts
+ *
+ * @module @pwfabric/runtime/validator
+ */
+import { ok, err, validationError } from '@pwfabric/contracts';
+// ============================================================
+// RUNTIME VALIDATOR IMPLEMENTATION
+// ============================================================
+/**
+ * Runtime contract validator
+ */
+export class RuntimeContractValidator {
+    validateInput(contract, data) {
+        try {
+            return contract.validateInput(data);
+        }
+        catch (error) {
+            const errors = [
+                validationError([], error instanceof Error ? error.message : 'Unknown validation error', 'validation_error'),
+            ];
+            return err(errors);
+        }
+    }
+    validateOutput(contract, data) {
+        try {
+            return contract.validateOutput(data);
+        }
+        catch (error) {
+            const errors = [
+                validationError([], error instanceof Error ? error.message : 'Unknown validation error', 'validation_error'),
+            ];
+            return err(errors);
+        }
+    }
+    validateCapability(capability) {
+        const errors = [];
+        // Validate capability has required fields
+        if (!capability.id) {
+            errors.push(validationError(['id'], 'Capability ID is required', 'required'));
+        }
+        if (!capability.version) {
+            errors.push(validationError(['version'], 'Capability version is required', 'required'));
+        }
+        if (!capability.contract) {
+            errors.push(validationError(['contract'], 'Capability contract is required', 'required'));
+        }
+        if (!capability.execute) {
+            errors.push(validationError(['execute'], 'Capability execute function is required', 'required'));
+        }
+        // Validate contract exists and has required methods
+        if (capability.contract) {
+            if (!capability.contract.validateInput) {
+                errors.push(validationError(['contract', 'validateInput'], 'Contract validateInput method is required', 'required'));
+            }
+            if (!capability.contract.validateOutput) {
+                errors.push(validationError(['contract', 'validateOutput'], 'Contract validateOutput method is required', 'required'));
+            }
+        }
+        if (errors.length > 0) {
+            return err(errors);
+        }
+        return ok(undefined);
+    }
+}
+// ============================================================
+// VALIDATION UTILITIES
+// ============================================================
+/**
+ * Create a contract validator
+ */
+export function createValidator() {
+    return new RuntimeContractValidator();
+}
+/**
+ * Validation result type guard
+ */
+export function isValidationSuccess(result) {
+    return result.success === true;
+}
+/**
+ * Validation result type guard for errors
+ */
+export function isValidationFailure(result) {
+    return result.success === false;
+}
+/**
+ * Format validation errors as a string
+ */
+export function formatValidationErrors(errors) {
+    return errors
+        .map((e) => {
+        const path = e.path.length > 0 ? `${e.path.join('.')}: ` : '';
+        return `${path}${e.message} (${e.code})`;
+    })
+        .join('\n');
+}
+//# sourceMappingURL=validator.js.map

package/dist/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Contract Validator\n *\n * Runtime validation for contracts\n *\n * @module @pwfabric/runtime/validator\n */\n\nimport type { Contract, Capability, ValidationResult, ValidationError } from '@pwfabric/contracts'\nimport { ok, err, validationError } from '@pwfabric/contracts'\n\n// ============================================================\n// VALIDATOR INTERFACE\n// ============================================================\n\n/**\n * Contract validator interface\n */\nexport interface ContractValidator {\n  /**\n   * Validate input against a contract\n   */\n  validateInput<T>(contract: Contract<T, unknown>, data: unknown): ValidationResult<T>\n\n  /**\n   * Validate output against a contract\n   */\n  validateOutput<T>(contract: Contract<unknown, T>, data: unknown): ValidationResult<T>\n\n  /**\n   * Validate a capability's contract\n   */\n  validateCapability(capability: Capability): ValidationResult<void>\n}\n\n// ============================================================\n// RUNTIME VALIDATOR IMPLEMENTATION\n// ============================================================\n\n/**\n * Runtime contract validator\n */\nexport class RuntimeContractValidator implements ContractValidator {\n  validateInput<T>(contract: Contract<T, unknown>, data: unknown): ValidationResult<T> {\n    try {\n      return contract.validateInput(data)\n    } catch (error) {\n      const errors: ValidationError[] = [\n        validationError(\n          [],\n          error instanceof Error ? error.message : 'Unknown validation error',\n          'validation_error'\n        ),\n      ]\n      return err(errors)\n    }\n  }\n\n  validateOutput<T>(contract: Contract<unknown, T>, data: unknown): ValidationResult<T> {\n    try {\n      return contract.validateOutput(data)\n    } catch (error) {\n      const errors: ValidationError[] = [\n        validationError(\n          [],\n          error instanceof Error ? error.message : 'Unknown validation error',\n          'validation_error'\n        ),\n      ]\n      return err(errors)\n    }\n  }\n\n  validateCapability(capability: Capability): ValidationResult<void> {\n    const errors: ValidationError[] = []\n\n    // Validate capability has required fields\n    if (!capability.id) {\n      errors.push(validationError(['id'], 'Capability ID is required', 'required'))\n    }\n\n    if (!capability.version) {\n      errors.push(validationError(['version'], 'Capability version is required', 'required'))\n    }\n\n    if (!capability.contract) {\n      errors.push(validationError(['contract'], 'Capability contract is required', 'required'))\n    }\n\n    if (!capability.execute) {\n      errors.push(\n        validationError(['execute'], 'Capability execute function is required', 'required')\n      )\n    }\n\n    // Validate contract exists and has required methods\n    if (capability.contract) {\n      if (!capability.contract.validateInput) {\n        errors.push(\n          validationError(\n            ['contract', 'validateInput'],\n            'Contract validateInput method is required',\n            'required'\n          )\n        )\n      }\n\n      if (!capability.contract.validateOutput) {\n        errors.push(\n          validationError(\n            ['contract', 'validateOutput'],\n            'Contract validateOutput method is required',\n            'required'\n          )\n        )\n      }\n    }\n\n    if (errors.length > 0) {\n      return err(errors)\n    }\n\n    return ok(undefined)\n  }\n}\n\n// ============================================================\n// VALIDATION UTILITIES\n// ============================================================\n\n/**\n * Create a contract validator\n */\nexport function createValidator(): ContractValidator {\n  return new RuntimeContractValidator()\n}\n\n/**\n * Validation result type guard\n */\nexport function isValidationSuccess<T>(\n  result: ValidationResult<T>\n): result is { success: true; data: T } {\n  return result.success === true\n}\n\n/**\n * Validation result type guard for errors\n */\nexport function isValidationFailure<T>(\n  result: ValidationResult<T>\n): result is { success: false; error: ValidationError[] } {\n  return result.success === false\n}\n\n/**\n * Format validation errors as a string\n */\nexport function formatValidationErrors(errors: ValidationError[]): string {\n  return errors\n    .map((e) => {\n      const path = e.path.length > 0 ? `${e.path.join('.')}: ` : ''\n      return `${path}${e.message} (${e.code})`\n    })\n    .join('\\n')\n}\n"]}

package/package.json

@@ -1,6 +1,109 @@
 {
   "name": "@pwfabric/runtime",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.0-rc.1",
+  "description": "PWFabric runtime and execution engine",
+  "type": "module",
+  "license": "BUSL-1.1",
+  "author": "PhiMajor Solutions",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pwfabric/pwfabric.git",
+    "directory": "packages/runtime"
+  },
+  "homepage": "https://github.com/pwfabric/pwfabric#readme",
+  "bugs": {
+    "url": "https://github.com/pwfabric/pwfabric/issues"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./adapters": {
+      "types": "./dist/adapters/index.d.ts",
+      "import": "./dist/adapters/index.js",
+      "default": "./dist/adapters/index.js"
+    },
+    "./capability": {
+      "types": "./dist/capability/index.d.ts",
+      "import": "./dist/capability/index.js",
+      "default": "./dist/capability/index.js"
+    },
+    "./blocks": {
+      "types": "./dist/blocks/index.d.ts",
+      "import": "./dist/blocks/index.js",
+      "default": "./dist/blocks/index.js"
+    },
+    "./auth": {
+      "types": "./dist/auth/index.d.ts",
+      "import": "./dist/auth/index.js",
+      "default": "./dist/auth/index.js"
+    },
+    "./data": {
+      "types": "./dist/data/index.d.ts",
+      "import": "./dist/data/index.js",
+      "default": "./dist/data/index.js"
+    },
+    "./blocks/*": {
+      "types": "./dist/blocks/*.d.ts",
+      "import": "./dist/blocks/*.js",
+      "default": "./dist/blocks/*.js"
+    },
+    "./render/*": {
+      "types": "./dist/render/*.d.ts",
+      "import": "./dist/render/*.js",
+      "default": "./dist/render/*.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/__tests__",
+    "!dist/**/__test-fixtures__",
+    "LICENSE",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "@pwfabric/contracts": "1.0.0-rc.1",
+    "@pwfabric/core": "1.0.0-rc.1"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.1",
+    "@testing-library/user-event": "^14.6.1",
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitest/coverage-v8": "^2.1.9",
+    "jsdom": "^26.0.0",
+    "next": "^16.1.5",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^2.0.0",
+    "zod": "^3.25.76"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "rm -rf dist tsconfig.tsbuildinfo && tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
 }