@logicsrc/validators 0.1.0

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { assertSchemaKind, parseDocument, validate } from "./index.js";
+function main(argv) {
+    const [, , kindArg, fileArg] = argv;
+    if (!kindArg || !fileArg) {
+        console.error("Usage: logicsrc-validate <task|agent|run|event|plugin|agentad-ad|agentad-placement|...> <file.yaml|file.json>");
+        process.exitCode = 2;
+        return;
+    }
+    const kind = assertSchemaKind(kindArg);
+    const filePath = resolve(process.cwd(), fileArg);
+    const input = readFileSync(filePath, "utf8");
+    const data = parseDocument(input, filePath);
+    const result = validate(kind, data);
+    if (!result.ok) {
+        console.error(`Invalid LogicSRC ${kind} document: ${filePath}`);
+        for (const error of result.errors) {
+            console.error(`- ${error.instancePath || "/"} ${error.message ?? "failed validation"}`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    console.log(`Valid LogicSRC ${kind} document: ${filePath}`);
+}
+main(process.argv);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEvE,SAAS,IAAI,CAAC,IAAc;IAC1B,MAAM,CAAC,EAAE,AAAD,EAAG,OAAO,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAEpC,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,CAAC,KAAK,CAAC,+GAA+G,CAAC,CAAC;QAC/H,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAEpC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,oBAAoB,IAAI,cAAc,QAAQ,EAAE,CAAC,CAAC;QAChE,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,YAAY,IAAI,GAAG,IAAI,KAAK,CAAC,OAAO,IAAI,mBAAmB,EAAE,CAAC,CAAC;QAC1F,CAAC;QACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,cAAc,QAAQ,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import type { ErrorObject } from "ajv";
+import { schemas, type SchemaKind } from "./schemas.js";
+export type ValidationResult = {
+    ok: true;
+    kind: SchemaKind;
+    data: unknown;
+} | {
+    ok: false;
+    kind: SchemaKind;
+    errors: ErrorObject[];
+};
+export declare function createValidator(): {
+    compile: (schema: unknown) => {
+        (data: unknown): boolean;
+        errors?: ErrorObject[] | null;
+    };
+};
+export declare function parseDocument(input: string, fileName?: string): unknown;
+export declare function validate(kind: SchemaKind, data: unknown): ValidationResult;
+export declare function assertSchemaKind(value: string): SchemaKind;
+export { schemas, type SchemaKind };

package/dist/index.js

@@ -0,0 +1,45 @@
+import * as Ajv2020Module from "ajv/dist/2020.js";
+import * as addFormatsModule from "ajv-formats";
+import { parse } from "yaml";
+import { isSchemaKind, schemas } from "./schemas.js";
+const Ajv2020 = Ajv2020Module.default;
+const addFormats = addFormatsModule.default;
+export function createValidator() {
+    const ajv = new Ajv2020({ allErrors: true, strict: true });
+    addFormats(ajv);
+    return ajv;
+}
+const _ajv = createValidator();
+const _compiledValidators = new Map();
+function getCompiledValidator(kind) {
+    if (!_compiledValidators.has(kind)) {
+        _compiledValidators.set(kind, _ajv.compile(schemas[kind]));
+    }
+    return _compiledValidators.get(kind);
+}
+export function parseDocument(input, fileName = "document") {
+    if (fileName.toLowerCase().endsWith(".json")) {
+        return JSON.parse(input);
+    }
+    return parse(input);
+}
+export function validate(kind, data) {
+    const validateDocument = getCompiledValidator(kind);
+    const ok = validateDocument(data);
+    if (ok) {
+        return { ok: true, kind, data };
+    }
+    return {
+        ok: false,
+        kind,
+        errors: validateDocument.errors ?? []
+    };
+}
+export function assertSchemaKind(value) {
+    if (!isSchemaKind(value)) {
+        throw new Error(`Unknown schema kind "${value}". Expected one of: ${Object.keys(schemas).join(", ")}`);
+    }
+    return value;
+}
+export { schemas };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,gBAAgB,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,OAAO,EAAmB,MAAM,cAAc,CAAC;AAEtE,MAAM,OAAO,GAAI,aAAiL,CAAC,OAAO,CAAC;AAC3M,MAAM,UAAU,GAAI,gBAAwF,CAAC,OAAO,CAAC;AAMrH,MAAM,UAAU,eAAe;IAC7B,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,UAAU,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;AAC/B,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAA+C,CAAC;AAEnF,SAAS,oBAAoB,CAAC,IAAgB;IAC5C,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,mBAAmB,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,QAAQ,GAAG,UAAU;IAChE,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAY,CAAC;IACtC,CAAC;IAED,OAAO,KAAK,CAAC,KAAK,CAAY,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAgB,EAAE,IAAa;IACtD,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,EAAE,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAElC,IAAI,EAAE,EAAE,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAClC,CAAC;IAED,OAAO;QACL,EAAE,EAAE,KAAK;QACT,IAAI;QACJ,MAAM,EAAE,gBAAgB,CAAC,MAAM,IAAI,EAAE;KACtC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,uBAAuB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzG,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,OAAO,EAAE,OAAO,EAAmB,CAAC"}

package/dist/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.test.js

@@ -0,0 +1,62 @@
+import { readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { describe, expect, it } from "vitest";
+import { assertSchemaKind, parseDocument, schemas, validate } from "./index.js";
+import { isSchemaKind } from "./schemas.js";
+describe("LogicSRC validators", () => {
+    it("validates the task fixture", () => {
+        const testDir = dirname(fileURLToPath(import.meta.url));
+        const file = resolve(testDir, "../../schemas/fixtures/task.yaml");
+        const data = parseDocument(readFileSync(file, "utf8"), file);
+        expect(validate("task", data).ok).toBe(true);
+    });
+    it("parses JSON files case-insensitively by extension", () => {
+        expect(parseDocument('{"ok":true}', "TASK.JSON")).toEqual({ ok: true });
+    });
+    it("rejects a task without a DID", () => {
+        const result = validate("task", {
+            type: "logicsrc.task",
+            version: "0.1",
+            title: "Missing DID",
+            description: "This should fail.",
+            board: "/qa",
+            status: "open"
+        });
+        expect(result.ok).toBe(false);
+    });
+    it("validates the AgentAd ad fixture", () => {
+        const testDir = dirname(fileURLToPath(import.meta.url));
+        const file = resolve(testDir, "../../schemas/fixtures/agentad-ad.yaml");
+        const data = parseDocument(readFileSync(file, "utf8"), file);
+        expect(validate("agentad-ad", data).ok).toBe(true);
+    });
+    it("rejects an AgentAd ad that is not disclosed as sponsored", () => {
+        const result = validate("agentad-ad", {
+            type: "agentad.ad",
+            version: "0.1",
+            id: "undisclosed",
+            advertiser_did: "acme.coinpay",
+            format: "text",
+            title: "Buy now",
+            url: "https://example.com",
+            disclosure: { sponsored: false, label: "Sponsored" }
+        });
+        expect(result.ok).toBe(false);
+    });
+});
+describe("isSchemaKind / assertSchemaKind prototype safety", () => {
+    it("rejects inherited Object.prototype keys", () => {
+        for (const key of ["toString", "constructor", "valueOf", "hasOwnProperty"]) {
+            expect(isSchemaKind(key)).toBe(false);
+            expect(() => assertSchemaKind(key)).toThrow(/Unknown schema kind/);
+        }
+    });
+    it("still accepts every real schema kind", () => {
+        for (const key of Object.keys(schemas)) {
+            expect(isSchemaKind(key)).toBe(true);
+            expect(assertSchemaKind(key)).toBe(key);
+        }
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/index.test.js.map

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