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

package/dist/surface/schemas.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Surface JSON Zod Schemas
+ *
+ * Zod validation schemas for Surface JSON definitions
+ *
+ * Provides schema-based validation to replace manual string-based
+ * validation in the interpreter. Ensures SurfaceJSON, LayoutJSON,
+ * and BindingJSON conform to their TypeScript interfaces.
+ *
+ * @module @pwfabric/runtime/surface/schemas
+ */
+import { z } from 'zod';
+import type { SurfaceJSON, LayoutJSON, BindingJSON } from './types.js';
+/**
+ * Valid environment types for surfaces
+ */
+export declare const environmentSchema: z.ZodEnum<["web", "api", "cli", "worker", "edge", "node", "native", "test"]>;
+/**
+ * Zod schema for BindingJSON
+ *
+ * Validates capability bindings in surface definitions.
+ * - capability: required string identifying the capability
+ * - alias: optional string alias for the binding
+ * - transform: optional input/output transform configuration
+ */
+export declare const bindingJsonSchema: z.ZodObject<{
+    capability: z.ZodString;
+    alias: z.ZodOptional<z.ZodString>;
+    transform: z.ZodOptional<z.ZodObject<{
+        input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        output: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        input?: Record<string, unknown> | undefined;
+        output?: Record<string, unknown> | undefined;
+    }, {
+        input?: Record<string, unknown> | undefined;
+        output?: Record<string, unknown> | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    capability: string;
+    alias?: string | undefined;
+    transform?: {
+        input?: Record<string, unknown> | undefined;
+        output?: Record<string, unknown> | undefined;
+    } | undefined;
+}, {
+    capability: string;
+    alias?: string | undefined;
+    transform?: {
+        input?: Record<string, unknown> | undefined;
+        output?: Record<string, unknown> | undefined;
+    } | undefined;
+}>;
+/**
+ * Zod schema for LayoutJSON
+ *
+ * Uses z.lazy() for recursive children validation.
+ * - type: required string identifying the layout element type
+ * - props: optional record of properties
+ * - children: optional array of nested LayoutJSON (recursive)
+ * - slot: optional named slot reference
+ * - if: optional conditional expression
+ * - each: optional loop configuration (items, as, key)
+ */
+export declare const layoutJsonSchema: z.ZodType;
+/**
+ * Zod schema for SurfaceJSON
+ *
+ * Validates the top-level surface definition structure.
+ * - id: required non-empty string
+ * - version: required non-empty string (semver)
+ * - environment: required enum of valid environment types
+ * - $schema: optional schema reference
+ * - metadata: optional name, description, tags
+ * - bindings: optional array of capability bindings
+ * - layout: required recursive layout definition
+ */
+export declare const surfaceJsonSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    version: z.ZodString;
+    environment: z.ZodEnum<["web", "api", "cli", "worker", "edge", "node", "native", "test"]>;
+    metadata: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        description?: string | undefined;
+        name?: string | undefined;
+        tags?: string[] | undefined;
+    }, {
+        description?: string | undefined;
+        name?: string | undefined;
+        tags?: string[] | undefined;
+    }>>;
+    bindings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        capability: z.ZodString;
+        alias: z.ZodOptional<z.ZodString>;
+        transform: z.ZodOptional<z.ZodObject<{
+            input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            output: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            input?: Record<string, unknown> | undefined;
+            output?: Record<string, unknown> | undefined;
+        }, {
+            input?: Record<string, unknown> | undefined;
+            output?: Record<string, unknown> | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        capability: string;
+        alias?: string | undefined;
+        transform?: {
+            input?: Record<string, unknown> | undefined;
+            output?: Record<string, unknown> | undefined;
+        } | undefined;
+    }, {
+        capability: string;
+        alias?: string | undefined;
+        transform?: {
+            input?: Record<string, unknown> | undefined;
+            output?: Record<string, unknown> | undefined;
+        } | undefined;
+    }>, "many">>;
+    layout: z.ZodType<any, z.ZodTypeDef, any>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    version: string;
+    environment: "web" | "api" | "cli" | "worker" | "edge" | "node" | "native" | "test";
+    metadata?: {
+        description?: string | undefined;
+        name?: string | undefined;
+        tags?: string[] | undefined;
+    } | undefined;
+    $schema?: string | undefined;
+    bindings?: {
+        capability: string;
+        alias?: string | undefined;
+        transform?: {
+            input?: Record<string, unknown> | undefined;
+            output?: Record<string, unknown> | undefined;
+        } | undefined;
+    }[] | undefined;
+    layout?: any;
+}, {
+    id: string;
+    version: string;
+    environment: "web" | "api" | "cli" | "worker" | "edge" | "node" | "native" | "test";
+    metadata?: {
+        description?: string | undefined;
+        name?: string | undefined;
+        tags?: string[] | undefined;
+    } | undefined;
+    $schema?: string | undefined;
+    bindings?: {
+        capability: string;
+        alias?: string | undefined;
+        transform?: {
+            input?: Record<string, unknown> | undefined;
+            output?: Record<string, unknown> | undefined;
+        } | undefined;
+    }[] | undefined;
+    layout?: any;
+}>;
+/**
+ * Type guard for SurfaceJSON
+ *
+ * Returns true if the provided data conforms to the SurfaceJSON schema.
+ */
+export declare function isSurfaceJSON(data: unknown): data is SurfaceJSON;
+/**
+ * Type guard for LayoutJSON
+ *
+ * Returns true if the provided data conforms to the LayoutJSON schema.
+ */
+export declare function isLayoutJSON(data: unknown): data is LayoutJSON;
+/**
+ * Type guard for BindingJSON
+ *
+ * Returns true if the provided data conforms to the BindingJSON schema.
+ */
+export declare function isBindingJSON(data: unknown): data is BindingJSON;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/surface/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/surface/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAMtE;;GAEG;AACH,eAAO,MAAM,iBAAiB,8EAS5B,CAAA;AAMF;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS5B,CAAA;AAMF;;;;;;;;;;GAUG;AAIH,eAAO,MAAM,gBAAgB,EAAE,CAAC,CAAC,OAehC,CAAA;AAiBD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ5B,CAAA;AAMF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,WAAW,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,UAAU,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,WAAW,CAEhE"}

package/dist/surface/schemas.js

@@ -0,0 +1,142 @@
+/**
+ * Surface JSON Zod Schemas
+ *
+ * Zod validation schemas for Surface JSON definitions
+ *
+ * Provides schema-based validation to replace manual string-based
+ * validation in the interpreter. Ensures SurfaceJSON, LayoutJSON,
+ * and BindingJSON conform to their TypeScript interfaces.
+ *
+ * @module @pwfabric/runtime/surface/schemas
+ */
+import { z } from 'zod';
+// ============================================================
+// ENVIRONMENT SCHEMA
+// ============================================================
+/**
+ * Valid environment types for surfaces
+ */
+export const environmentSchema = z.enum([
+    'web',
+    'api',
+    'cli',
+    'worker',
+    'edge',
+    'node',
+    'native',
+    'test',
+]);
+// ============================================================
+// BINDING JSON SCHEMA
+// ============================================================
+/**
+ * Zod schema for BindingJSON
+ *
+ * Validates capability bindings in surface definitions.
+ * - capability: required string identifying the capability
+ * - alias: optional string alias for the binding
+ * - transform: optional input/output transform configuration
+ */
+export const bindingJsonSchema = z.object({
+    capability: z.string().min(1, 'Binding capability must be a non-empty string'),
+    alias: z.string().optional(),
+    transform: z
+        .object({
+        input: z.record(z.unknown()).optional(),
+        output: z.record(z.unknown()).optional(),
+    })
+        .optional(),
+});
+// ============================================================
+// LAYOUT JSON SCHEMA (RECURSIVE)
+// ============================================================
+/**
+ * Zod schema for LayoutJSON
+ *
+ * Uses z.lazy() for recursive children validation.
+ * - type: required string identifying the layout element type
+ * - props: optional record of properties
+ * - children: optional array of nested LayoutJSON (recursive)
+ * - slot: optional named slot reference
+ * - if: optional conditional expression
+ * - each: optional loop configuration (items, as, key)
+ */
+// Recursive schema uses z.lazy() with a forward-declared type variable.
+// The explicit ZodType cast is required because z.lazy() needs the
+// schema variable to exist at the point of self-reference in children.
+export const layoutJsonSchema = z.lazy(() => z.object({
+    type: z.string().min(1, 'Layout must have a type'),
+    props: z.record(z.unknown()).optional(),
+    children: z.array(layoutJsonSchema).optional(),
+    slot: z.string().optional(),
+    if: z.string().optional(),
+    each: z
+        .object({
+        items: z.string().min(1, 'Loop layout must have items expression'),
+        as: z.string().min(1, 'Loop layout must have as variable name'),
+        key: z.string().optional(),
+    })
+        .optional(),
+}));
+// ============================================================
+// SURFACE JSON SCHEMA
+// ============================================================
+/**
+ * Metadata schema for surface definitions
+ */
+const metadataSchema = z
+    .object({
+    name: z.string().optional(),
+    description: z.string().optional(),
+    tags: z.array(z.string()).optional(),
+})
+    .optional();
+/**
+ * Zod schema for SurfaceJSON
+ *
+ * Validates the top-level surface definition structure.
+ * - id: required non-empty string
+ * - version: required non-empty string (semver)
+ * - environment: required enum of valid environment types
+ * - $schema: optional schema reference
+ * - metadata: optional name, description, tags
+ * - bindings: optional array of capability bindings
+ * - layout: required recursive layout definition
+ */
+export const surfaceJsonSchema = z.object({
+    $schema: z.string().optional(),
+    id: z.string().min(1, 'Surface must have a string id'),
+    version: z.string().min(1, 'Surface must have a string version'),
+    environment: environmentSchema,
+    metadata: metadataSchema,
+    bindings: z.array(bindingJsonSchema).optional(),
+    layout: layoutJsonSchema,
+});
+// ============================================================
+// TYPE GUARDS
+// ============================================================
+/**
+ * Type guard for SurfaceJSON
+ *
+ * Returns true if the provided data conforms to the SurfaceJSON schema.
+ */
+export function isSurfaceJSON(data) {
+    return surfaceJsonSchema.safeParse(data).success;
+}
+/**
+ * Type guard for LayoutJSON
+ *
+ * Returns true if the provided data conforms to the LayoutJSON schema.
+ */
+export function isLayoutJSON(data) {
+    return layoutJsonSchema.safeParse(data).success;
+}
+/**
+ * Type guard for BindingJSON
+ *
+ * Returns true if the provided data conforms to the BindingJSON schema.
+ */
+export function isBindingJSON(data) {
+    return bindingJsonSchema.safeParse(data).success;
+}
+//# sourceMappingURL=schemas.js.map

package/dist/surface/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/surface/schemas.ts"],"names":[],"mappings":"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"}

package/dist/surface/transforms.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Typed Transform Wrappers
+ *
+ * Typed runtime wrappers for TransformDescriptor.config.
+ * These do NOT modify @pwfabric/contracts. They provide typed alternatives
+ * that narrow the opaque Record<string, unknown> config.
+ *
+ * @module @pwfabric/runtime/surface/transforms
+ */
+import { z } from 'zod';
+import type { TransformDescriptor } from '@pwfabric/contracts';
+/**
+ * Config for 'map' transforms
+ */
+export interface MapTransformConfig {
+    readonly field: string;
+    readonly mapper: string;
+}
+/**
+ * Config for 'filter' transforms
+ */
+export interface FilterTransformConfig {
+    readonly field: string;
+    readonly predicate: string;
+}
+/**
+ * Config for 'pick' transforms
+ */
+export interface PickTransformConfig {
+    readonly fields: readonly string[];
+}
+/**
+ * Config for 'omit' transforms
+ */
+export interface OmitTransformConfig {
+    readonly fields: readonly string[];
+}
+/**
+ * Config for 'custom' transforms
+ */
+export interface CustomTransformConfig {
+    readonly handler: string;
+    readonly params?: Record<string, unknown>;
+}
+/**
+ * Discriminated union of all typed transform configs
+ */
+export type TypedTransformConfig = {
+    readonly type: 'map';
+    readonly config: MapTransformConfig;
+} | {
+    readonly type: 'filter';
+    readonly config: FilterTransformConfig;
+} | {
+    readonly type: 'pick';
+    readonly config: PickTransformConfig;
+} | {
+    readonly type: 'omit';
+    readonly config: OmitTransformConfig;
+} | {
+    readonly type: 'custom';
+    readonly config: CustomTransformConfig;
+};
+export declare const mapTransformConfigSchema: z.ZodObject<{
+    field: z.ZodString;
+    mapper: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    field: string;
+    mapper: string;
+}, {
+    field: string;
+    mapper: string;
+}>;
+export declare const filterTransformConfigSchema: z.ZodObject<{
+    field: z.ZodString;
+    predicate: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    field: string;
+    predicate: string;
+}, {
+    field: string;
+    predicate: string;
+}>;
+export declare const pickTransformConfigSchema: z.ZodObject<{
+    fields: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    fields: string[];
+}, {
+    fields: string[];
+}>;
+export declare const omitTransformConfigSchema: z.ZodObject<{
+    fields: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    fields: string[];
+}, {
+    fields: string[];
+}>;
+export declare const customTransformConfigSchema: z.ZodObject<{
+    handler: z.ZodString;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    handler: string;
+    params?: Record<string, unknown> | undefined;
+}, {
+    handler: string;
+    params?: Record<string, unknown> | undefined;
+}>;
+/**
+ * Result of validating a transform config
+ */
+export interface TransformValidationResult {
+    readonly valid: boolean;
+    readonly errors: readonly string[];
+}
+/**
+ * Validate a transform descriptor's config against the typed schema
+ * for the given transform type.
+ */
+export declare function validateTransformConfig(type: TransformDescriptor['type'], config: Record<string, unknown>): TransformValidationResult;
+/**
+ * Type guard that narrows an opaque TransformDescriptor into
+ * a TypedTransformConfig if the config passes validation.
+ */
+export declare function narrowTransformDescriptor(descriptor: TransformDescriptor): TypedTransformConfig | null;
+/**
+ * Create a typed 'map' transform descriptor
+ */
+export declare function createMapTransform(config: MapTransformConfig): TransformDescriptor;
+/**
+ * Create a typed 'filter' transform descriptor
+ */
+export declare function createFilterTransform(config: FilterTransformConfig): TransformDescriptor;
+/**
+ * Create a typed 'pick' transform descriptor
+ */
+export declare function createPickTransform(config: PickTransformConfig): TransformDescriptor;
+/**
+ * Create a typed 'omit' transform descriptor
+ */
+export declare function createOmitTransform(config: OmitTransformConfig): TransformDescriptor;
+/**
+ * Create a typed 'custom' transform descriptor
+ */
+export declare function createCustomTransform(config: CustomTransformConfig): TransformDescriptor;
+//# sourceMappingURL=transforms.d.ts.map

package/dist/surface/transforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transforms.d.ts","sourceRoot":"","sources":["../../src/surface/transforms.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAM9D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC1C;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,GAC7D;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAA;CAAE,GACnE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,GAC/D;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,GAC/D;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAA;CAAE,CAAA;AAMvE,eAAO,MAAM,wBAAwB;;;;;;;;;EAGnC,CAAA;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;EAGtC,CAAA;AAEF,eAAO,MAAM,yBAAyB;;;;;;EAEpC,CAAA;AAEF,eAAO,MAAM,yBAAyB;;;;;;EAEpC,CAAA;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;EAGtC,CAAA;AAiBF;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CACnC;AAMD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,mBAAmB,CAAC,MAAM,CAAC,EACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,yBAAyB,CAa3B;AAMD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,mBAAmB,GAC9B,oBAAoB,GAAG,IAAI,CAiB7B;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,mBAAmB,CAGlF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,mBAAmB,CAGxF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,mBAAmB,CAGpF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,mBAAmB,CAGpF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,mBAAmB,CAGxF"}

package/dist/surface/transforms.js

@@ -0,0 +1,120 @@
+/**
+ * Typed Transform Wrappers
+ *
+ * Typed runtime wrappers for TransformDescriptor.config.
+ * These do NOT modify @pwfabric/contracts. They provide typed alternatives
+ * that narrow the opaque Record<string, unknown> config.
+ *
+ * @module @pwfabric/runtime/surface/transforms
+ */
+import { z } from 'zod';
+// ============================================================
+// ZOD SCHEMAS
+// ============================================================
+export const mapTransformConfigSchema = z.object({
+    field: z.string().min(1),
+    mapper: z.string().min(1),
+});
+export const filterTransformConfigSchema = z.object({
+    field: z.string().min(1),
+    predicate: z.string().min(1),
+});
+export const pickTransformConfigSchema = z.object({
+    fields: z.array(z.string().min(1)).min(1),
+});
+export const omitTransformConfigSchema = z.object({
+    fields: z.array(z.string().min(1)).min(1),
+});
+export const customTransformConfigSchema = z.object({
+    handler: z.string().min(1),
+    params: z.record(z.unknown()).optional(),
+});
+/**
+ * Map of transform types to their Zod schemas
+ */
+const transformConfigSchemas = {
+    map: mapTransformConfigSchema,
+    filter: filterTransformConfigSchema,
+    pick: pickTransformConfigSchema,
+    omit: omitTransformConfigSchema,
+    custom: customTransformConfigSchema,
+};
+// ============================================================
+// VALIDATION FUNCTION
+// ============================================================
+/**
+ * Validate a transform descriptor's config against the typed schema
+ * for the given transform type.
+ */
+export function validateTransformConfig(type, config) {
+    const schema = transformConfigSchemas[type];
+    const result = schema.safeParse(config);
+    if (result.success) {
+        return { valid: true, errors: [] };
+    }
+    return {
+        valid: false,
+        errors: result.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`),
+    };
+}
+// ============================================================
+// TYPE GUARD
+// ============================================================
+/**
+ * Type guard that narrows an opaque TransformDescriptor into
+ * a TypedTransformConfig if the config passes validation.
+ */
+export function narrowTransformDescriptor(descriptor) {
+    if (!descriptor.config) {
+        return null;
+    }
+    const schema = transformConfigSchemas[descriptor.type];
+    const result = schema.safeParse(descriptor.config);
+    if (!result.success) {
+        return null;
+    }
+    // The type assertion is safe because Zod validated the config shape
+    return {
+        type: descriptor.type,
+        config: result.data,
+    };
+}
+// ============================================================
+// FACTORY FUNCTIONS
+// ============================================================
+/**
+ * Create a typed 'map' transform descriptor
+ */
+export function createMapTransform(config) {
+    const parsed = mapTransformConfigSchema.parse(config);
+    return { type: 'map', config: parsed };
+}
+/**
+ * Create a typed 'filter' transform descriptor
+ */
+export function createFilterTransform(config) {
+    const parsed = filterTransformConfigSchema.parse(config);
+    return { type: 'filter', config: parsed };
+}
+/**
+ * Create a typed 'pick' transform descriptor
+ */
+export function createPickTransform(config) {
+    const parsed = pickTransformConfigSchema.parse(config);
+    return { type: 'pick', config: { ...parsed, fields: [...parsed.fields] } };
+}
+/**
+ * Create a typed 'omit' transform descriptor
+ */
+export function createOmitTransform(config) {
+    const parsed = omitTransformConfigSchema.parse(config);
+    return { type: 'omit', config: { ...parsed, fields: [...parsed.fields] } };
+}
+/**
+ * Create a typed 'custom' transform descriptor
+ */
+export function createCustomTransform(config) {
+    const parsed = customTransformConfigSchema.parse(config);
+    return { type: 'custom', config: parsed };
+}
+//# sourceMappingURL=transforms.js.map

package/dist/surface/transforms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transforms.js","sourceRoot":"","sources":["../../src/surface/transforms.ts"],"names":[],"mappings":"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"}