@vue-skuilder/common 0.1.11-9 → 0.1.11

package/dist/index.d.ts

@@ -6,8 +6,10 @@ export * from './logshim.js';
 export * from './validators.js';
 export * from './fieldConverters.js';
 export * from './db.js';
+export * from './logger.js';
 export * from './bulkImport/cardParser.js';
 export * from './bulkImport/types.js';
 export * from './interfaces/index.js';
 export * from './enums/index.js';
+export * from './schemas/dataShapeToZod.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AAExB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AAGtC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAE5B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AAGtC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,6BAA6B,CAAC"}

package/dist/index.js

@@ -22,12 +22,15 @@ __exportStar(require("./logshim.js"), exports);
 __exportStar(require("./validators.js"), exports);
 __exportStar(require("./fieldConverters.js"), exports);
 __exportStar(require("./db.js"), exports);
+__exportStar(require("./logger.js"), exports);
 __exportStar(require("./bulkImport/cardParser.js"), exports);
 __exportStar(require("./bulkImport/types.js"), exports);
 // interfaces
 __exportStar(require("./interfaces/index.js"), exports);
 // enums
 __exportStar(require("./enums/index.js"), exports);
+// schemas
+__exportStar(require("./schemas/dataShapeToZod.js"), exports);
 // docker utilities (Node.js only - not exported in main index for browser compatibility)
 // Use explicit import: import { CouchDBManager } from '@vue-skuilder/common/docker'
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AAExB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AAEtC,aAAa;AACb,cAAc,uBAAuB,CAAC;AAEtC,QAAQ;AACR,cAAc,kBAAkB,CAAC;AAEjC,yFAAyF;AACzF,oFAAoF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAE5B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AAEtC,aAAa;AACb,cAAc,uBAAuB,CAAC;AAEtC,QAAQ;AACR,cAAc,kBAAkB,CAAC;AAEjC,UAAU;AACV,cAAc,6BAA6B,CAAC;AAE5C,yFAAyF;AACzF,oFAAoF"}

package/dist/index.mjs

@@ -6,12 +6,15 @@ export * from './logshim.mjs';
 export * from './validators.mjs';
 export * from './fieldConverters.mjs';
 export * from './db.mjs';
+export * from './logger.mjs';
 export * from './bulkImport/cardParser.mjs';
 export * from './bulkImport/types.mjs';
 // interfaces
 export * from './interfaces/index.mjs';
 // enums
 export * from './enums/index.mjs';
+// schemas
+export * from './schemas/dataShapeToZod.mjs';
 // docker utilities (Node.js only - not exported in main index for browser compatibility)
 // Use explicit import: import { CouchDBManager } from '@vue-skuilder/common/docker'
 //# sourceMappingURL=index.js.map

package/dist/logger.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Standard logger interface for vue-skuilder packages
+ *
+ * This interface enables dependency injection of logging functionality,
+ * allowing different runtime contexts to provide appropriate logger implementations:
+ * - Node.js contexts can use Winston
+ * - Browser contexts can use console wrappers
+ * - Test contexts can use mock loggers
+ */
+export interface SkLogger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+/**
+ * No-op logger implementation for contexts where logging is not needed
+ */
+export declare const noOpLogger: SkLogger;
+/**
+ * Console-based logger for browser/development contexts
+ * Uses console methods with appropriate ESLint suppressions
+ */
+export declare const consoleLogger: SkLogger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAClD;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,QAKxB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,QAK3B,CAAC"}

package/dist/logger.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.consoleLogger = exports.noOpLogger = void 0;
+/**
+ * No-op logger implementation for contexts where logging is not needed
+ */
+exports.noOpLogger = {
+    debug: () => { },
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+};
+/**
+ * Console-based logger for browser/development contexts
+ * Uses console methods with appropriate ESLint suppressions
+ */
+exports.consoleLogger = {
+    debug: (message, ...args) => console.debug(message, ...args), // eslint-disable-line no-console
+    info: (message, ...args) => console.info(message, ...args), // eslint-disable-line no-console
+    warn: (message, ...args) => console.warn(message, ...args), // eslint-disable-line no-console
+    error: (message, ...args) => console.error(message, ...args), // eslint-disable-line no-console
+};
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAgBA;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAa;IAClC,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAa;IACrC,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,EAAE,iCAAiC;IAClH,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,EAAE,iCAAiC;IAChH,IAAI,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,EAAE,iCAAiC;IAChH,KAAK,EAAE,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,EAAE,iCAAiC;CACnH,CAAC"}

package/dist/logger.mjs

@@ -0,0 +1,20 @@
+/**
+ * No-op logger implementation for contexts where logging is not needed
+ */
+export const noOpLogger = {
+    debug: () => { },
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+};
+/**
+ * Console-based logger for browser/development contexts
+ * Uses console methods with appropriate ESLint suppressions
+ */
+export const consoleLogger = {
+    debug: (message, ...args) => console.debug(message, ...args), // eslint-disable-line no-console
+    info: (message, ...args) => console.info(message, ...args), // eslint-disable-line no-console
+    warn: (message, ...args) => console.warn(message, ...args), // eslint-disable-line no-console
+    error: (message, ...args) => console.error(message, ...args), // eslint-disable-line no-console
+};
+//# sourceMappingURL=logger.js.map

package/dist/namespacer.js

@@ -5,7 +5,7 @@ class NameSpacer {
     static getDataShapeDescriptor(shapeStr) {
         const splitArray = shapeStr.split('.');
         if (splitArray.length !== 3) {
-            throw new Error('shapeStr not valid');
+            throw new Error(`shapeStr [${shapeStr}] not valid`);
         }
         else {
             return {

package/dist/namespacer.js.map

@@ -1 +1 @@
-{"version":3,"file":"namespacer.js","sourceRoot":"","sources":["../src/namespacer.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,UAAU;IACd,MAAM,CAAC,sBAAsB,CAAC,QAAgB;QACnD,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEvC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,OAAO;gBACL,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;gBACrB,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;aACzB,CAAC;QACJ,CAAC;IACH,CAAC;IACM,MAAM,CAAC,kBAAkB,CAAC,gBAAiC;QAChE,OAAO,GAAG,gBAAgB,CAAC,MAAM,cAAc,gBAAgB,CAAC,SAAS,EAAE,CAAC;IAC9E,CAAC;IAEM,MAAM,CAAC,iBAAiB,CAAC,OAAe;QAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEtC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,OAAO;gBACL,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;gBACrB,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;gBAC3B,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;aACpB,CAAC;QACJ,CAAC;IACH,CAAC;IAEM,MAAM,CAAC,aAAa,CAAC,eAA+B;QACzD,OAAO,CACL,GAAG,eAAe,CAAC,MAAM,YAAY;YACrC,GAAG,eAAe,CAAC,YAAY,IAAI,eAAe,CAAC,IAAI,EAAE,CAC1D,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,qBAAqB,CAAC,WAAmB;QACrD,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE1C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,OAAO;gBACL,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;gBACrB,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;aAC5B,CAAC;QACJ,CAAC;IACH,CAAC;IAEM,MAAM,CAAC,iBAAiB,CAAC,mBAAuC;QACrE,OAAO,GAAG,mBAAmB,CAAC,MAAM,aAAa,mBAAmB,CAAC,YAAY,EAAE,CAAC;IACtF,CAAC;CACF"}
+{"version":3,"file":"namespacer.js","sourceRoot":"","sources":["../src/namespacer.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,UAAU;IACd,MAAM,CAAC,sBAAsB,CAAC,QAAgB;QACnD,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEvC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,aAAa,QAAQ,aAAa,CAAC,CAAC;QACtD,CAAC;aAAM,CAAC;YACN,OAAO;gBACL,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;gBACrB,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;aACzB,CAAC;QACJ,CAAC;IACH,CAAC;IACM,MAAM,CAAC,kBAAkB,CAAC,gBAAiC;QAChE,OAAO,GAAG,gBAAgB,CAAC,MAAM,cAAc,gBAAgB,CAAC,SAAS,EAAE,CAAC;IAC9E,CAAC;IAEM,MAAM,CAAC,iBAAiB,CAAC,OAAe;QAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEtC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,OAAO;gBACL,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;gBACrB,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;gBAC3B,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;aACpB,CAAC;QACJ,CAAC;IACH,CAAC;IAEM,MAAM,CAAC,aAAa,CAAC,eAA+B;QACzD,OAAO,CACL,GAAG,eAAe,CAAC,MAAM,YAAY;YACrC,GAAG,eAAe,CAAC,YAAY,IAAI,eAAe,CAAC,IAAI,EAAE,CAC1D,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,qBAAqB,CAAC,WAAmB;QACrD,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE1C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,OAAO;gBACL,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;gBACrB,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;aAC5B,CAAC;QACJ,CAAC;IACH,CAAC;IAEM,MAAM,CAAC,iBAAiB,CAAC,mBAAuC;QACrE,OAAO,GAAG,mBAAmB,CAAC,MAAM,aAAa,mBAAmB,CAAC,YAAY,EAAE,CAAC;IACtF,CAAC;CACF"}

package/dist/namespacer.mjs

@@ -2,7 +2,7 @@ export class NameSpacer {
     static getDataShapeDescriptor(shapeStr) {
         const splitArray = shapeStr.split('.');
         if (splitArray.length !== 3) {
-            throw new Error('shapeStr not valid');
+            throw new Error(`shapeStr [${shapeStr}] not valid`);
         }
         else {
             return {

package/dist/schemas/dataShapeToZod.d.ts

@@ -0,0 +1,11 @@
+import { z, ZodRawShape } from 'zod';
+import { DataShape } from '../index.js';
+/**
+ * Converts a DataShape to a Zod schema
+ */
+export declare function toZod(dataShape: DataShape): z.ZodObject<ZodRawShape>;
+/**
+ * Converts a DataShape to JSON Schema string using Zod v4 native conversion
+ */
+export declare function toZodJSON(dataShape: DataShape): string;
+//# sourceMappingURL=dataShapeToZod.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dataShapeToZod.d.ts","sourceRoot":"","sources":["../../src/schemas/dataShapeToZod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AACrC,OAAO,EAAE,SAAS,EAAsC,MAAM,aAAa,CAAC;AAiG5E;;GAEG;AACH,wBAAgB,KAAK,CAAC,SAAS,EAAE,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAQpE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAItD"}

package/dist/schemas/dataShapeToZod.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toZod = toZod;
+exports.toZodJSON = toZodJSON;
+const zod_1 = require("zod");
+const index_js_1 = require("../index.js");
+/**
+ * Converts a FieldType enum to appropriate Zod schema
+ */
+function fieldTypeToZodSchema(field) {
+    let baseSchema;
+    switch (field.type) {
+        case index_js_1.FieldType.STRING:
+            baseSchema = zod_1.z.string().min(1, `${field.name} cannot be empty`);
+            break;
+        case index_js_1.FieldType.MARKDOWN:
+            baseSchema = zod_1.z.string().min(1, `${field.name} cannot be empty`);
+            // Special handling for known patterns like Blanks
+            if (field.name === 'Input') {
+                baseSchema = baseSchema
+                    .refine((value) => typeof value === 'string' && value.includes('{{') && value.includes('}}'), 'Must contain at least one blank in format {{answer}} or {{answer1|answer2||distractor}}')
+                    .describe("Markdown text with blanks. Format: {{answer}} for fill-in or {{answer1|answer2||distractor1|distractor2}} for multiple choice. Use the 'fill-in-card-authoring' MCP prompt for detailed syntax guidance.");
+            }
+            else {
+                baseSchema = baseSchema.describe('Markdown content');
+            }
+            break;
+        case index_js_1.FieldType.NUMBER:
+            baseSchema = zod_1.z.number().describe(`Numeric value for ${field.name}`);
+            break;
+        case index_js_1.FieldType.INT:
+            baseSchema = zod_1.z.number().int().describe(`Integer value for ${field.name}`);
+            break;
+        case index_js_1.FieldType.IMAGE:
+            baseSchema = zod_1.z.any().optional().describe('Image file');
+            break;
+        case index_js_1.FieldType.AUDIO:
+            baseSchema = zod_1.z.any().optional().describe('Audio file');
+            break;
+        case index_js_1.FieldType.MIDI:
+            baseSchema = zod_1.z.any().optional().describe('MIDI file');
+            break;
+        case index_js_1.FieldType.MEDIA_UPLOADS:
+            baseSchema = zod_1.z
+                .array(zod_1.z.any())
+                .optional()
+                .describe('Optional media files (images, audio, etc.)');
+            break;
+        case index_js_1.FieldType.CHESS_PUZZLE:
+            baseSchema = zod_1.z
+                .string()
+                .min(1, 'Chess puzzle cannot be empty')
+                .describe('Chess puzzle in FEN or PGN format');
+            break;
+        default:
+            baseSchema = zod_1.z.any().describe(`Field of type ${field.type}`);
+    }
+    // Add custom validation if present
+    if (field.validator) {
+        const originalValidator = field.validator;
+        baseSchema = baseSchema.refine((value) => {
+            try {
+                const result = originalValidator.test(String(value));
+                return result.status === index_js_1.Status.ok;
+            }
+            catch {
+                return false;
+            }
+        }, {
+            message: originalValidator.instructions || `Validation failed for ${field.name}`,
+        });
+        // Add validator instructions as description if available
+        if (originalValidator.instructions) {
+            baseSchema = baseSchema.describe(`${baseSchema.description || ''}\nInstructions: ${originalValidator.instructions}`.trim());
+        }
+    }
+    return baseSchema;
+}
+/**
+ * Converts a DataShape to a Zod schema
+ */
+function toZod(dataShape) {
+    const schemaFields = {};
+    dataShape.fields.forEach((field) => {
+        schemaFields[field.name] = fieldTypeToZodSchema(field);
+    });
+    return zod_1.z.object(schemaFields).describe(`DataShape: ${dataShape.name} - Schema for card creation`);
+}
+/**
+ * Converts a DataShape to JSON Schema string using Zod v4 native conversion
+ */
+function toZodJSON(dataShape) {
+    const zodSchema = toZod(dataShape);
+    const jsonSchema = zod_1.z.toJSONSchema(zodSchema);
+    return JSON.stringify(jsonSchema, null, 2);
+}
+//# sourceMappingURL=dataShapeToZod.js.map

package/dist/schemas/dataShapeToZod.js.map

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

package/dist/schemas/dataShapeToZod.mjs

@@ -0,0 +1,93 @@
+import { z } from 'zod';
+import { FieldType, Status } from '../index.mjs';
+/**
+ * Converts a FieldType enum to appropriate Zod schema
+ */
+function fieldTypeToZodSchema(field) {
+    let baseSchema;
+    switch (field.type) {
+        case FieldType.STRING:
+            baseSchema = z.string().min(1, `${field.name} cannot be empty`);
+            break;
+        case FieldType.MARKDOWN:
+            baseSchema = z.string().min(1, `${field.name} cannot be empty`);
+            // Special handling for known patterns like Blanks
+            if (field.name === 'Input') {
+                baseSchema = baseSchema
+                    .refine((value) => typeof value === 'string' && value.includes('{{') && value.includes('}}'), 'Must contain at least one blank in format {{answer}} or {{answer1|answer2||distractor}}')
+                    .describe("Markdown text with blanks. Format: {{answer}} for fill-in or {{answer1|answer2||distractor1|distractor2}} for multiple choice. Use the 'fill-in-card-authoring' MCP prompt for detailed syntax guidance.");
+            }
+            else {
+                baseSchema = baseSchema.describe('Markdown content');
+            }
+            break;
+        case FieldType.NUMBER:
+            baseSchema = z.number().describe(`Numeric value for ${field.name}`);
+            break;
+        case FieldType.INT:
+            baseSchema = z.number().int().describe(`Integer value for ${field.name}`);
+            break;
+        case FieldType.IMAGE:
+            baseSchema = z.any().optional().describe('Image file');
+            break;
+        case FieldType.AUDIO:
+            baseSchema = z.any().optional().describe('Audio file');
+            break;
+        case FieldType.MIDI:
+            baseSchema = z.any().optional().describe('MIDI file');
+            break;
+        case FieldType.MEDIA_UPLOADS:
+            baseSchema = z
+                .array(z.any())
+                .optional()
+                .describe('Optional media files (images, audio, etc.)');
+            break;
+        case FieldType.CHESS_PUZZLE:
+            baseSchema = z
+                .string()
+                .min(1, 'Chess puzzle cannot be empty')
+                .describe('Chess puzzle in FEN or PGN format');
+            break;
+        default:
+            baseSchema = z.any().describe(`Field of type ${field.type}`);
+    }
+    // Add custom validation if present
+    if (field.validator) {
+        const originalValidator = field.validator;
+        baseSchema = baseSchema.refine((value) => {
+            try {
+                const result = originalValidator.test(String(value));
+                return result.status === Status.ok;
+            }
+            catch {
+                return false;
+            }
+        }, {
+            message: originalValidator.instructions || `Validation failed for ${field.name}`,
+        });
+        // Add validator instructions as description if available
+        if (originalValidator.instructions) {
+            baseSchema = baseSchema.describe(`${baseSchema.description || ''}\nInstructions: ${originalValidator.instructions}`.trim());
+        }
+    }
+    return baseSchema;
+}
+/**
+ * Converts a DataShape to a Zod schema
+ */
+export function toZod(dataShape) {
+    const schemaFields = {};
+    dataShape.fields.forEach((field) => {
+        schemaFields[field.name] = fieldTypeToZodSchema(field);
+    });
+    return z.object(schemaFields).describe(`DataShape: ${dataShape.name} - Schema for card creation`);
+}
+/**
+ * Converts a DataShape to JSON Schema string using Zod v4 native conversion
+ */
+export function toZodJSON(dataShape) {
+    const zodSchema = toZod(dataShape);
+    const jsonSchema = z.toJSONSchema(zodSchema);
+    return JSON.stringify(jsonSchema, null, 2);
+}
+//# sourceMappingURL=dataShapeToZod.js.map

package/dist/wire-format.d.ts

@@ -59,6 +59,7 @@ type NamespacedDatashape = string;
 export interface DataShape55 {
     name: NamespacedDatashape;
     questionTypes: PouchDB.Core.DocumentId[];
+    serializedZodSchema?: string;
 }
 type NamespacedQuestion = string;
 export interface QuestionType55 {
@@ -131,6 +132,7 @@ export interface PackCourse extends IServerRequest {
     type: ServerRequestType.PACK_COURSE;
     courseId: string;
     outputPath?: string;
+    couchdbUrl?: string;
     response: {
         status: Status;
         ok: boolean;

package/dist/wire-format.d.ts.map

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

package/dist/wire-format.js.map

@@ -1 +1 @@
-{"version":3,"file":"wire-format.js","sourceRoot":"","sources":["../src/wire-format.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,MAKX;AALD,WAAY,MAAM;IAChB,uCAA6B,CAAA;IAC7B,mBAAS,CAAA;IACT,6BAAmB,CAAA;IACnB,yBAAe,CAAA;AACjB,CAAC,EALW,MAAM,KAAN,MAAM,QAKjB;AA+JD,MAAM,CAAN,IAAY,iBASX;AATD,WAAY,iBAAiB;IAC3B,0DAAqC,CAAA;IACrC,0DAAqC,CAAA;IACrC,sDAAiC,CAAA;IACjC,wDAAmC,CAAA;IACnC,oDAA+B,CAAA;IAC/B,oDAA+B,CAAA;IAC/B,wDAAmC,CAAA;IACnC,gDAA2B,CAAA;AAC7B,CAAC,EATW,iBAAiB,KAAjB,iBAAiB,QAS5B"}
+{"version":3,"file":"wire-format.js","sourceRoot":"","sources":["../src/wire-format.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,MAKX;AALD,WAAY,MAAM;IAChB,uCAA6B,CAAA;IAC7B,mBAAS,CAAA;IACT,6BAAmB,CAAA;IACnB,yBAAe,CAAA;AACjB,CAAC,EALW,MAAM,KAAN,MAAM,QAKjB;AAiKD,MAAM,CAAN,IAAY,iBASX;AATD,WAAY,iBAAiB;IAC3B,0DAAqC,CAAA;IACrC,0DAAqC,CAAA;IACrC,sDAAiC,CAAA;IACjC,wDAAmC,CAAA;IACnC,oDAA+B,CAAA;IAC/B,oDAA+B,CAAA;IAC/B,wDAAmC,CAAA;IACnC,gDAA2B,CAAA;AAC7B,CAAC,EATW,iBAAiB,KAAjB,iBAAiB,QAS5B"}

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.1.11-9",
+  "version": "0.1.11",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -32,7 +32,8 @@
     "typescript": "~5.7.2"
   },
   "dependencies": {
-    "moment": "^2.30.1"
+    "moment": "^2.30.1",
+    "zod": "^4.0.0"
   },
-  "stableVersion": "0.1.10"
+  "stableVersion": "0.1.11"
 }

package/src/index.ts

@@ -6,6 +6,7 @@ export * from './logshim.js';
 export * from './validators.js';
 export * from './fieldConverters.js';
 export * from './db.js';
+export * from './logger.js';
 
 export * from './bulkImport/cardParser.js';
 export * from './bulkImport/types.js';
@@ -16,5 +17,8 @@ export * from './interfaces/index.js';
 // enums
 export * from './enums/index.js';
 
+// schemas
+export * from './schemas/dataShapeToZod.js';
+
 // docker utilities (Node.js only - not exported in main index for browser compatibility)
 // Use explicit import: import { CouchDBManager } from '@vue-skuilder/common/docker'

package/src/logger.ts

@@ -0,0 +1,36 @@
+/**
+ * Standard logger interface for vue-skuilder packages
+ *
+ * This interface enables dependency injection of logging functionality,
+ * allowing different runtime contexts to provide appropriate logger implementations:
+ * - Node.js contexts can use Winston
+ * - Browser contexts can use console wrappers
+ * - Test contexts can use mock loggers
+ */
+export interface SkLogger {
+  debug(message: string, ...args: unknown[]): void;
+  info(message: string, ...args: unknown[]): void;
+  warn(message: string, ...args: unknown[]): void;
+  error(message: string, ...args: unknown[]): void;
+}
+
+/**
+ * No-op logger implementation for contexts where logging is not needed
+ */
+export const noOpLogger: SkLogger = {
+  debug: () => {},
+  info: () => {},
+  warn: () => {},
+  error: () => {},
+};
+
+/**
+ * Console-based logger for browser/development contexts
+ * Uses console methods with appropriate ESLint suppressions
+ */
+export const consoleLogger: SkLogger = {
+  debug: (message: string, ...args: unknown[]) => console.debug(message, ...args), // eslint-disable-line no-console
+  info: (message: string, ...args: unknown[]) => console.info(message, ...args), // eslint-disable-line no-console
+  warn: (message: string, ...args: unknown[]) => console.warn(message, ...args), // eslint-disable-line no-console
+  error: (message: string, ...args: unknown[]) => console.error(message, ...args), // eslint-disable-line no-console
+};

package/src/namespacer.ts

@@ -3,7 +3,7 @@ export class NameSpacer {
     const splitArray = shapeStr.split('.');
 
     if (splitArray.length !== 3) {
-      throw new Error('shapeStr not valid');
+      throw new Error(`shapeStr [${shapeStr}] not valid`);
     } else {
       return {
         course: splitArray[0],

package/src/schemas/dataShapeToZod.ts

@@ -0,0 +1,119 @@
+import { z, ZodRawShape } from 'zod';
+import { DataShape, FieldDefinition, FieldType, Status } from '../index.js';
+
+/**
+ * Converts a FieldType enum to appropriate Zod schema
+ */
+function fieldTypeToZodSchema(field: FieldDefinition): z.ZodTypeAny {
+  let baseSchema: z.ZodTypeAny;
+
+  switch (field.type) {
+    case FieldType.STRING:
+      baseSchema = z.string().min(1, `${field.name} cannot be empty`);
+      break;
+
+    case FieldType.MARKDOWN:
+      baseSchema = z.string().min(1, `${field.name} cannot be empty`);
+
+      // Special handling for known patterns like Blanks
+      if (field.name === 'Input') {
+        baseSchema = baseSchema
+          .refine(
+            (value): value is string => typeof value === 'string' && value.includes('{{') && value.includes('}}'),
+            'Must contain at least one blank in format {{answer}} or {{answer1|answer2||distractor}}'
+          )
+          .describe(
+            "Markdown text with blanks. Format: {{answer}} for fill-in or {{answer1|answer2||distractor1|distractor2}} for multiple choice. Use the 'fill-in-card-authoring' MCP prompt for detailed syntax guidance."
+          );
+      } else {
+        baseSchema = baseSchema.describe('Markdown content');
+      }
+      break;
+
+    case FieldType.NUMBER:
+      baseSchema = z.number().describe(`Numeric value for ${field.name}`);
+      break;
+
+    case FieldType.INT:
+      baseSchema = z.number().int().describe(`Integer value for ${field.name}`);
+      break;
+
+    case FieldType.IMAGE:
+      baseSchema = z.any().optional().describe('Image file');
+      break;
+
+    case FieldType.AUDIO:
+      baseSchema = z.any().optional().describe('Audio file');
+      break;
+
+    case FieldType.MIDI:
+      baseSchema = z.any().optional().describe('MIDI file');
+      break;
+
+    case FieldType.MEDIA_UPLOADS:
+      baseSchema = z
+        .array(z.any())
+        .optional()
+        .describe('Optional media files (images, audio, etc.)');
+      break;
+
+    case FieldType.CHESS_PUZZLE:
+      baseSchema = z
+        .string()
+        .min(1, 'Chess puzzle cannot be empty')
+        .describe('Chess puzzle in FEN or PGN format');
+      break;
+
+    default:
+      baseSchema = z.any().describe(`Field of type ${field.type}`);
+  }
+
+  // Add custom validation if present
+  if (field.validator) {
+    const originalValidator = field.validator;
+    baseSchema = baseSchema.refine(
+      (value) => {
+        try {
+          const result = originalValidator.test(String(value));
+          return result.status === Status.ok;
+        } catch {
+          return false;
+        }
+      },
+      {
+        message: originalValidator.instructions || `Validation failed for ${field.name}`,
+      }
+    );
+
+    // Add validator instructions as description if available
+    if (originalValidator.instructions) {
+      baseSchema = baseSchema.describe(
+        `${baseSchema.description || ''}\nInstructions: ${originalValidator.instructions}`.trim()
+      );
+    }
+  }
+
+  return baseSchema;
+}
+
+/**
+ * Converts a DataShape to a Zod schema
+ */
+export function toZod(dataShape: DataShape): z.ZodObject<ZodRawShape> {
+  const schemaFields: Record<string, z.ZodTypeAny> = {};
+
+  dataShape.fields.forEach((field) => {
+    schemaFields[field.name] = fieldTypeToZodSchema(field);
+  });
+
+  return z.object(schemaFields).describe(`DataShape: ${dataShape.name} - Schema for card creation`);
+}
+
+/**
+ * Converts a DataShape to JSON Schema string using Zod v4 native conversion
+ */
+export function toZodJSON(dataShape: DataShape): string {
+  const zodSchema = toZod(dataShape);
+  const jsonSchema = z.toJSONSchema(zodSchema);
+  return JSON.stringify(jsonSchema, null, 2);
+}

package/src/wire-format.ts

@@ -66,6 +66,7 @@ export interface DataShape55 {
   // [ ] rename this to something else - disambiguate from DataShape in base-course
   name: NamespacedDatashape;
   questionTypes: PouchDB.Core.DocumentId[];
+  serializedZodSchema?: string;
 }
 
 type NamespacedQuestion = string; // ${course}.question.${question}
@@ -143,6 +144,7 @@ export interface PackCourse extends IServerRequest {
   type: ServerRequestType.PACK_COURSE;
   courseId: string;
   outputPath?: string;
+  couchdbUrl?: string; // Optional full CouchDB connection URL for studio mode
   response: {
     status: Status;
     ok: boolean;