ag-common 0.0.861 → 0.0.864

package/dist/api/helpers/index.d.ts

@@ -13,3 +13,4 @@ export * from './ssm';
 export * from './ssmInfra';
 export * from './sts';
 export * from './validations';
+export * from './zod';

package/dist/api/helpers/index.js

@@ -29,3 +29,4 @@ __exportStar(require("./ssm"), exports);
 __exportStar(require("./ssmInfra"), exports);
 __exportStar(require("./sts"), exports);
 __exportStar(require("./validations"), exports);
+__exportStar(require("./zod"), exports);

package/dist/api/helpers/zod.d.ts

@@ -0,0 +1,19 @@
+import type { z } from 'zod';
+/**
+ * Convert a Zod object schema to its code representation for use in LLM prompts.
+ * Outputs actual Zod code like: z.object({ field: z.string().nullable().describe("...") })
+ *
+ * Uses _def.typeName instead of instanceof checks to work across different Zod module instances.
+ *
+ * @example
+ * const schema = z.object({
+ *   name: z.string().describe("The user's name"),
+ *   age: z.number().optional().describe("Age in years"),
+ * });
+ * const code = zodSchemaToString(schema);
+ * // Returns: z.object({
+ * //   name: z.string().describe("The user's name"),
+ * //   age: z.number().optional().describe("Age in years")
+ * // })
+ */
+export declare function zodSchemaToString(schema: z.ZodObject<z.ZodRawShape>): string;

package/dist/api/helpers/zod.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.zodSchemaToString = zodSchemaToString;
+/**
+ * Convert a Zod object schema to its code representation for use in LLM prompts.
+ * Outputs actual Zod code like: z.object({ field: z.string().nullable().describe("...") })
+ *
+ * Uses _def.typeName instead of instanceof checks to work across different Zod module instances.
+ *
+ * @example
+ * const schema = z.object({
+ *   name: z.string().describe("The user's name"),
+ *   age: z.number().optional().describe("Age in years"),
+ * });
+ * const code = zodSchemaToString(schema);
+ * // Returns: z.object({
+ * //   name: z.string().describe("The user's name"),
+ * //   age: z.number().optional().describe("Age in years")
+ * // })
+ */
+function zodSchemaToString(schema) {
+    const fields = [];
+    for (const [key, value] of Object.entries(schema.shape)) {
+        const zodType = value;
+        const typeCode = zodTypeToCode(zodType);
+        fields.push(`  ${key}: ${typeCode}`);
+    }
+    return `z.object({\n${fields.join(',\n')}\n})`;
+}
+/**
+ * Get the type name from a Zod type's internal definition.
+ * This works across different Zod module instances unlike instanceof.
+ */
+function getTypeName(zodType) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return zodType._def.typeName;
+}
+/**
+ * Recursively convert a Zod type to its code representation
+ */
+function zodTypeToCode(zodType) {
+    const description = zodType.description;
+    const describeChain = description
+        ? `.describe(${JSON.stringify(description)})`
+        : '';
+    const typeName = getTypeName(zodType);
+    // Handle wrapper types first (they wrap inner types)
+    if (typeName === 'ZodOptional') {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const innerType = zodType._def.innerType;
+        const inner = zodTypeToCode(innerType).replace(/\.describe\([^)]+\)$/, '');
+        return `${inner}.optional()${describeChain}`;
+    }
+    if (typeName === 'ZodNullable') {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const innerType = zodType._def.innerType;
+        const inner = zodTypeToCode(innerType).replace(/\.describe\([^)]+\)$/, '');
+        return `${inner}.nullable()${describeChain}`;
+    }
+    // Handle base types
+    if (typeName === 'ZodString') {
+        return `z.string()${describeChain}`;
+    }
+    if (typeName === 'ZodNumber') {
+        return `z.number()${describeChain}`;
+    }
+    if (typeName === 'ZodBoolean') {
+        return `z.boolean()${describeChain}`;
+    }
+    if (typeName === 'ZodEnum') {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const values = zodType._def.values;
+        const enumStr = values.map((v) => JSON.stringify(v)).join(', ');
+        return `z.enum([${enumStr}])${describeChain}`;
+    }
+    if (typeName === 'ZodArray') {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const elementType = zodType._def.type;
+        const innerType = zodTypeToCode(elementType);
+        return `z.array(${innerType})${describeChain}`;
+    }
+    if (typeName === 'ZodObject') {
+        // Nested object - recurse
+        return zodSchemaToString(zodType);
+    }
+    if (typeName === 'ZodLiteral') {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const value = zodType._def.value;
+        return `z.literal(${JSON.stringify(value)})${describeChain}`;
+    }
+    if (typeName === 'ZodUnion') {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const options = zodType._def.options;
+        const optionsStr = options.map((opt) => zodTypeToCode(opt)).join(', ');
+        return `z.union([${optionsStr}])${describeChain}`;
+    }
+    if (typeName === 'ZodRecord') {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const valueType = zodType._def.valueType;
+        return `z.record(${zodTypeToCode(valueType)})${describeChain}`;
+    }
+    if (typeName === 'ZodTuple') {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const items = zodType._def.items;
+        const itemsStr = items.map((item) => zodTypeToCode(item)).join(', ');
+        return `z.tuple([${itemsStr}])${describeChain}`;
+    }
+    throw new Error(`Unsupported Zod type: ${typeName}`);
+}

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.0.861",
+  "version": "0.0.864",
   "name": "ag-common",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -73,7 +73,8 @@
     "jwks-rsa": "^3.2.0",
     "node-cache": "^5.1.2",
     "rimraf": "^6.1.2",
-    "storybook": "^10.1.11"
+    "storybook": "^10.1.11",
+    "zod": "^3.25.76"
   },
   "files": [
     "dist/**/*",