@metaobjectsdev/runtime-ts 0.5.0-rc.1

package/dist/validator-runner.js

@@ -0,0 +1,155 @@
+// Pure function: NEVER throws. ObjectManager wraps a non-ok result in a ValidationError on writes;
+// om.validate() returns the result directly.
+import { TYPE_FIELD, TYPE_VALIDATOR, VALIDATOR_SUBTYPE_REQUIRED, VALIDATOR_SUBTYPE_LENGTH, VALIDATOR_SUBTYPE_REGEX, FIELD_SUBTYPE_STRING, FIELD_SUBTYPE_INT, FIELD_SUBTYPE_LONG, FIELD_SUBTYPE_SHORT, FIELD_SUBTYPE_BYTE, FIELD_SUBTYPE_DOUBLE, FIELD_SUBTYPE_FLOAT, FIELD_SUBTYPE_BOOLEAN, FIELD_ATTR_REQUIRED, FIELD_ATTR_MAX_LENGTH, FIELD_ATTR_DEFAULT, VALIDATOR_ATTR_MIN, VALIDATOR_ATTR_MAX, VALIDATOR_ATTR_PATTERN, } from "@metaobjectsdev/metadata";
+const NUMERIC_FIELD_SUBTYPES = new Set([
+    FIELD_SUBTYPE_INT, FIELD_SUBTYPE_LONG, FIELD_SUBTYPE_SHORT, FIELD_SUBTYPE_BYTE,
+    FIELD_SUBTYPE_DOUBLE, FIELD_SUBTYPE_FLOAT,
+]);
+export function runValidators(entity, data, opts = {}) {
+    const errors = [];
+    for (const field of entity.ownChildren()) {
+        if (field.type !== TYPE_FIELD)
+            continue;
+        const present = Object.prototype.hasOwnProperty.call(data, field.name);
+        const value = data[field.name];
+        // In partial mode (update), absent keys are "untouched" — only validate fields the caller passed.
+        // Fields with a `@default` are also exempt from required-on-insert: the
+        // DB will fill them in (e.g. timestamps with `@default: CURRENT_TIMESTAMP`,
+        // booleans with `@default: false`).
+        const required = isRequired(field);
+        const hasDefault = field.ownAttr(FIELD_ATTR_DEFAULT) !== undefined;
+        if (required && (value === undefined || value === null)) {
+            if (opts.partial && !present)
+                continue;
+            if (hasDefault)
+                continue;
+            errors.push({
+                field: field.name,
+                rule: "required",
+                message: `'${field.name}' is required`,
+            });
+            continue;
+        }
+        if (value === undefined || value === null)
+            continue;
+        const typeError = checkType(field.subType, value);
+        if (typeError !== null) {
+            errors.push({
+                field: field.name,
+                rule: "type",
+                message: typeError,
+                expected: field.subType,
+                received: typeof value,
+            });
+            continue;
+        }
+        const maxLen = resolveMaxLength(field);
+        const minLen = resolveMinLength(field);
+        if (typeof value === "string") {
+            if (maxLen !== undefined && value.length > maxLen) {
+                errors.push({
+                    field: field.name,
+                    rule: "length",
+                    message: `'${field.name}' must be at most ${maxLen} chars (got ${value.length})`,
+                    expected: { max: maxLen },
+                    received: value.length,
+                });
+            }
+            if (minLen !== undefined && value.length < minLen) {
+                errors.push({
+                    field: field.name,
+                    rule: "length",
+                    message: `'${field.name}' must be at least ${minLen} chars (got ${value.length})`,
+                    expected: { min: minLen },
+                    received: value.length,
+                });
+            }
+        }
+        for (const child of field.ownChildren()) {
+            if (child.type !== TYPE_VALIDATOR)
+                continue;
+            if (child.subType !== VALIDATOR_SUBTYPE_REGEX)
+                continue;
+            const pattern = child.ownAttr(VALIDATOR_ATTR_PATTERN);
+            if (typeof pattern !== "string")
+                continue;
+            if (typeof value !== "string")
+                continue;
+            let regex;
+            try {
+                regex = new RegExp(pattern);
+            }
+            catch {
+                errors.push({
+                    field: field.name,
+                    rule: "regex",
+                    message: `'${field.name}' has an invalid validator pattern: ${pattern}`,
+                    expected: pattern,
+                });
+                continue;
+            }
+            if (!regex.test(value)) {
+                errors.push({
+                    field: field.name,
+                    rule: "regex",
+                    message: `'${field.name}' does not match required pattern`,
+                    expected: pattern,
+                    received: value,
+                });
+            }
+        }
+    }
+    return errors.length === 0 ? { ok: true } : { ok: false, errors };
+}
+function isRequired(field) {
+    if (field.ownAttr(FIELD_ATTR_REQUIRED) === true)
+        return true;
+    for (const child of field.ownChildren()) {
+        if (child.type === TYPE_VALIDATOR && child.subType === VALIDATOR_SUBTYPE_REQUIRED)
+            return true;
+    }
+    return false;
+}
+function resolveMaxLength(field) {
+    const attr = field.ownAttr(FIELD_ATTR_MAX_LENGTH);
+    if (typeof attr === "number")
+        return attr;
+    for (const child of field.ownChildren()) {
+        if (child.type !== TYPE_VALIDATOR)
+            continue;
+        if (child.subType !== VALIDATOR_SUBTYPE_LENGTH)
+            continue;
+        const max = child.ownAttr(VALIDATOR_ATTR_MAX);
+        if (typeof max === "number")
+            return max;
+    }
+    return undefined;
+}
+function resolveMinLength(field) {
+    for (const child of field.ownChildren()) {
+        if (child.type !== TYPE_VALIDATOR)
+            continue;
+        if (child.subType !== VALIDATOR_SUBTYPE_LENGTH)
+            continue;
+        const min = child.ownAttr(VALIDATOR_ATTR_MIN);
+        if (typeof min === "number")
+            return min;
+    }
+    return undefined;
+}
+function checkType(subType, value) {
+    if (subType === FIELD_SUBTYPE_STRING) {
+        if (typeof value !== "string")
+            return `expected string`;
+    }
+    else if (NUMERIC_FIELD_SUBTYPES.has(subType)) {
+        if (typeof value !== "number")
+            return `expected number`;
+    }
+    else if (subType === FIELD_SUBTYPE_BOOLEAN) {
+        if (typeof value !== "boolean")
+            return `expected boolean`;
+    }
+    return null;
+}
+//# sourceMappingURL=validator-runner.js.map

package/dist/validator-runner.js.map

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

package/dist/view.d.ts

@@ -0,0 +1,19 @@
+import type { MetaData } from "@metaobjectsdev/metadata";
+export interface FieldViewSpec {
+    fieldName: string;
+    fieldSubType: string;
+    viewName: string;
+    /** The view node's subType (e.g., "text", "number", "select"). */
+    controlType: string;
+    attrs: Record<string, unknown>;
+    required?: boolean;
+}
+export interface EntityViewSpec {
+    entityName: string;
+    viewName: string;
+    fields: FieldViewSpec[];
+}
+export declare function viewFieldNames(entity: MetaData, viewName: string): string[];
+export declare function fieldViewSpec(entity: MetaData, fieldName: string, viewName: string): FieldViewSpec | null;
+export declare function entityViewSpec(entity: MetaData, viewName: string): EntityViewSpec;
+//# sourceMappingURL=view.d.ts.map

package/dist/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../src/view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAQzD,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAS3E;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAsBzG;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,CAcjF"}

package/dist/view.js

@@ -0,0 +1,60 @@
+import { TYPE_FIELD, TYPE_VIEW, TYPE_VALIDATOR, VALIDATOR_SUBTYPE_REQUIRED, FIELD_ATTR_REQUIRED, } from "@metaobjectsdev/metadata";
+import { MetadataError } from "./errors.js";
+export function viewFieldNames(entity, viewName) {
+    const names = [];
+    for (const field of entity.ownChildren()) {
+        if (field.type !== TYPE_FIELD)
+            continue;
+        if (field.ownChildren().some((c) => c.type === TYPE_VIEW && c.name === viewName)) {
+            names.push(field.name);
+        }
+    }
+    return names;
+}
+export function fieldViewSpec(entity, fieldName, viewName) {
+    const field = entity.ownChildren().find((c) => c.type === TYPE_FIELD && c.name === fieldName);
+    if (!field)
+        return null;
+    const view = field.ownChildren().find((c) => c.type === TYPE_VIEW && c.name === viewName);
+    if (!view)
+        return null;
+    const attrs = {};
+    for (const key of view.ownAttrs().keys()) {
+        attrs[key] = view.ownAttr(key);
+    }
+    const required = isFieldRequired(field);
+    const result = {
+        fieldName: field.name,
+        fieldSubType: field.subType,
+        viewName,
+        controlType: view.subType,
+        attrs,
+    };
+    if (required)
+        result.required = true;
+    return result;
+}
+export function entityViewSpec(entity, viewName) {
+    const fields = [];
+    for (const field of entity.ownChildren()) {
+        if (field.type !== TYPE_FIELD)
+            continue;
+        const spec = fieldViewSpec(entity, field.name, viewName);
+        if (spec !== null)
+            fields.push(spec);
+    }
+    if (fields.length === 0) {
+        throw new MetadataError(`No fields tagged with view '${viewName}' on entity '${entity.name}'`, { entity: entity.name });
+    }
+    return { entityName: entity.name, viewName, fields };
+}
+function isFieldRequired(field) {
+    if (field.ownAttr(FIELD_ATTR_REQUIRED) === true)
+        return true;
+    for (const child of field.ownChildren()) {
+        if (child.type === TYPE_VALIDATOR && child.subType === VALIDATOR_SUBTYPE_REQUIRED)
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=view.js.map

package/dist/view.js.map

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

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@metaobjectsdev/runtime-ts",
+  "version": "0.5.0-rc.1",
+  "description": "Node-side runtime helpers for MetaObjects: Fastify route builders, Drizzle filter/sort integration, Kysely drivers.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./drivers": {
+      "bun": "./src/drivers/index.ts",
+      "types": "./dist/drivers/index.d.ts",
+      "default": "./dist/drivers/index.js"
+    },
+    "./fastify": {
+      "bun": "./src/fastify/index.ts",
+      "types": "./dist/fastify/index.d.ts",
+      "default": "./dist/fastify/index.js"
+    },
+    "./drizzle-fastify": {
+      "bun": "./src/drizzle-fastify/index.ts",
+      "types": "./dist/drizzle-fastify/index.d.ts",
+      "default": "./dist/drizzle-fastify/index.js"
+    }
+  },
+  "files": ["dist", "src", "README.md", "LICENSE"],
+  "scripts": {
+    "build": "tsc -p .",
+    "typecheck": "tsc -p tsconfig.typecheck.json"
+  },
+  "license": "Apache-2.0",
+  "author": "Doug Mealing <doug@dougmealing.com>",
+  "homepage": "https://metaobjects.dev",
+  "bugs": {
+  "url": "https://github.com/metaobjectsdev/metaobjects/issues"
+},
+"repository": {
+  "type": "git",
+  "url": "https://github.com/metaobjectsdev/metaobjects.git",
+  "directory": "server/typescript/packages/runtime-ts"
+},
+"keywords": ["metaobjects", "runtime", "fastify", "drizzle", "kysely"],
+"publishConfig": {
+"access": "public"
+},
+"dependencies": {
+  "@metaobjectsdev/metadata": "0.5.0",
+  "qs": "^6.13.0"
+},
+"peerDependencies": {
+  "drizzle-orm": ">=0.36.0",
+  "fastify": ">=5.0.0",
+  "kysely": ">=0.27.0",
+  "zod": ">=3.23.0"
+},
+"peerDependenciesMeta": {
+  "drizzle-orm": {
+    "optional": true
+  },
+  "fastify": {
+    "optional": true
+  },
+  "kysely": {
+    "optional": true
+  },
+  "zod": {
+    "optional": true
+  }
+},
+"devDependencies": {
+  "@libsql/client": "^0.15.0",
+  "@libsql/kysely-libsql": "^0.4.1",
+  "@types/qs": "^6.9.0",
+  "bun-types": "latest",
+  "drizzle-orm": "^0.45.1",
+  "fastify": "^5.6.2",
+  "jsdom": "^29.1.1",
+  "kysely": "^0.27.0",
+  "pg-mem": "^3.0.4",
+  "typescript": "^5.6.0",
+  "zod": "^4.4.3"
+}
+}

package/src/constants.ts

@@ -0,0 +1,7 @@
+export const DEFAULT_IF_MISSING = "throw" as const;
+
+// Mirrors SP2's path-traversal guard — entity names appear in filesystem paths.
+export const VALID_ENTITY_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
+
+export const REF_SEPARATOR = ":";
+export const REF_PK_SEPARATOR = ",";