@docstack/client 0.0.4 → 0.0.6

package/lib/core/attribute.js

@@ -0,0 +1,406 @@
+var _a;
+import z from "zod";
+import { Attribute as Attribute_, ATTRIBUTE_TYPES } from "@docstack/shared";
+/**
+ * Represents a single attribute (field) within a Class schema.
+ *
+ * Attributes define the structure of documents, including their type,
+ * validation rules (via Zod), and configuration options like mandatory,
+ * default values, primary keys, and foreign key references.
+ *
+ * Use the static factory method {@link Attribute.create} to instantiate
+ * attributes with proper validation and persistence.
+ *
+ * @example
+ * ```typescript
+ * // Create a string attribute
+ * const titleAttr = await Attribute.create(taskClass, 'title', 'string', 'Task Title', {
+ *     mandatory: true,
+ *     maxLength: 200
+ * });
+ *
+ * // Create a foreign key reference
+ * const assigneeAttr = await Attribute.create(taskClass, 'assigneeId', 'foreign_key', 'Assigned User', {
+ *     targetClass: 'User'
+ * });
+ * ```
+ *
+ * @extends Attribute_
+ */
+class Attribute extends Attribute_ {
+    /**
+     * Creates a new Attribute instance.
+     * For most use cases, prefer using {@link Attribute.create} which also persists the attribute.
+     *
+     * @param classObj - The parent Class for this attribute
+     * @param name - The attribute name
+     * @param type - The attribute type (e.g., 'string', 'integer', 'boolean', 'enum')
+     * @param description - Optional description
+     * @param config - Type-specific configuration options
+     */
+    constructor(classObj = null, name, type, description, config) {
+        super(classObj, name, type, config);
+        /** Zod schema for runtime validation of this field. */
+        this.field = z.any();
+        /**
+         * Validates that reference-type attributes have proper domain configuration.
+         * Called automatically during {@link Attribute.create}.
+         * @throws Error if the reference configuration is invalid
+         */
+        this.ensureReferenceConfigIsValid = async () => {
+            if (this.model.type !== "reference") {
+                return;
+            }
+            if (!this.class) {
+                throw new Error(`Attribute '${this.name}' must belong to a class to validate reference configuration.`);
+            }
+            const stack = this.class.getStack();
+            if (!stack) {
+                throw new Error(`Class '${this.class.getName()}' is not attached to a stack.`);
+            }
+            const config = this.model.config;
+            const domainName = config.domain;
+            if (typeof domainName !== "string" || domainName.length === 0) {
+                throw new Error(`Attribute '${this.name}' of type 'reference' must declare a domain.`);
+            }
+            if (config.isArray) {
+                throw new Error(`Attribute '${this.name}' of type 'reference' cannot be an array.`);
+            }
+            const domain = await stack.getDomain(domainName);
+            if (!domain) {
+                throw new Error(`Domain '${domainName}' was not found for attribute '${this.name}'.`);
+            }
+            const classId = this.class.id;
+            switch (domain.relation) {
+                case "1:N":
+                    if (classId !== domain.targetClass.id) {
+                        throw new Error(`Given classId '${classId}' Reference attributes for domain '${domainName}' can only be added to class '${domain.targetClass}'.`);
+                    }
+                    break;
+                case "N:1":
+                    if (classId !== domain.sourceClass.id) {
+                        throw new Error(`Given classId '${classId}' Reference attributes for domain '${domainName}' can only be added to class '${domain.sourceClass}'.`);
+                    }
+                    break;
+                case "1:1":
+                    if (classId !== domain.sourceClass.id && classId !== domain.targetClass.id) {
+                        throw new Error(`Class '${classId}' is not part of domain '${domainName}'.`);
+                    }
+                    break;
+                case "N:N":
+                    throw new Error(`Domain '${domainName}' does not support reference attributes.`);
+                default:
+                    throw new Error(`Unsupported relation '${domain.relation}' for domain '${domainName}'.`);
+            }
+        };
+        /**
+         * Builds the Zod validation schema based on attribute type and configuration.
+         * Called automatically during construction.
+         */
+        this.setField = () => {
+            const { name, type, config } = this.model;
+            let field;
+            switch (type) {
+                // ... existing cases for 'string', 'number', 'boolean', 'date' ...
+                case 'string':
+                    field = z.string();
+                    if (config.maxLength !== undefined) {
+                        field = field.max(config.maxLength);
+                    }
+                    break;
+                case 'integer':
+                    field = z.number();
+                    if (typeof config.min === 'number') {
+                        field = field.min(config.min);
+                    }
+                    if (typeof config.max === 'number') {
+                        field = field.max(config.max);
+                    }
+                    break;
+                // case 'date':
+                //     field = z.date();
+                //     break;
+                case 'decimal':
+                    field = z.number();
+                    // min and max validation
+                    if (typeof config.min === 'number') {
+                        field = field.min(config.min);
+                    }
+                    if (typeof config.max === 'number') {
+                        field = field.max(config.max);
+                    }
+                    // decimal precision validation (with refinement)
+                    if (typeof config.precision === 'number' && config.precision >= 0) {
+                        const isPrecise = (value) => {
+                            if (typeof value !== 'number')
+                                return true;
+                            const valueAsString = value.toString();
+                            const decimalPart = valueAsString.split('.')[1];
+                            const decimalPlaces = decimalPart ? decimalPart.length : 0;
+                            return decimalPlaces <= config.precision;
+                        };
+                        field = field.refine(isPrecise, `Number cannot have more than ${config.precision} decimals.`);
+                    }
+                    break;
+                case 'boolean':
+                    field = z.boolean();
+                    break;
+                case "object":
+                    field = z.object({});
+                    break;
+                case 'enum':
+                    if (!config.values || !Array.isArray(config.values) || config.values.length === 0) {
+                        throw new Error(`Attribute '${name}' of type 'enum' must have a non-empty 'values' array in its config.`);
+                    }
+                    const enumValues = config.values.map(v => v.value);
+                    field = z.enum(enumValues);
+                    break;
+                case 'foreign_key':
+                    if (!config.targetClass) {
+                        throw new Error(`Attribute '${name}' of type 'foreign_key' is missing a 'targetClass' in its config.`);
+                    }
+                    const foreignClass = config.targetClass;
+                    const baseSchema = z.string();
+                    field = baseSchema.refine(async (documentIdOrIds) => {
+                        var _b;
+                        const idsToValidate = Array.isArray(documentIdOrIds) ? documentIdOrIds : [documentIdOrIds];
+                        if (idsToValidate.length === 0) {
+                            return true;
+                        }
+                        try {
+                            if (this.class) {
+                                const stack = this.class.getStack();
+                                if (stack) {
+                                    const promises = idsToValidate.map(id => stack.db.get(id));
+                                    const fetchResult = await Promise.all(promises);
+                                    return true;
+                                }
+                                else
+                                    throw new Error("Missing stack connection");
+                            }
+                            else
+                                throw new Error("Missing class parentship");
+                        }
+                        catch (error) {
+                            if (error.status === 404) {
+                                console.error(`Foreign key validation failed: document not found in class '${foreignClass}'. ${(_b = this.class) === null || _b === void 0 ? void 0 : _b.getName()}`, { error });
+                                return false;
+                            }
+                            throw error;
+                        }
+                    }, {
+                        message: `One or more documents not found in class '${foreignClass}'.`,
+                    });
+                    break;
+                case 'reference':
+                    field = z.string().min(1);
+                    break;
+                default:
+                    throw new Error(`Unsupported schema type: '${type}' for field '${name}'`);
+            }
+            // These rules are applied regardless of the type, and in the correct order
+            if (config.defaultValue) {
+                field = field.default(config.defaultValue);
+            }
+            if (config.mandatory !== true) {
+                field = field.optional();
+            }
+            if (config.isArray === true) {
+                field = z.array(field);
+            }
+            this.field = field;
+        };
+        /**
+         * Checks if this attribute is marked as a primary key.
+         * @returns `true` if this is a primary key attribute
+         */
+        this.isPrimaryKey = () => {
+            let model = this.getModel();
+            return !!model.config.primaryKey;
+        };
+        /**
+         * Checks if this attribute is mandatory (required).
+         * @returns `true` if the attribute is mandatory
+         */
+        this.isMandatory = () => {
+            return !!this.model.config.mandatory;
+        };
+        /**
+         * Returns the AttributeModel for this attribute.
+         * @returns The underlying AttributeModel
+         */
+        this.getModel = () => {
+            return this.model;
+        };
+        /**
+         * Returns the parent Class for this attribute.
+         * @returns The Class instance
+         * @throws Error if the attribute has no parent class
+         */
+        this.getClass = () => {
+            if (this.class)
+                return this.class;
+            else
+                throw Error("Missing class configuration for this attribute");
+        };
+        /**
+         * Validates a value against this attribute's Zod schema.
+         *
+         * @param data - The value to validate
+         * @returns Zod safe parse result with success status and data/error
+         *
+         * @example
+         * ```typescript
+         * const result = await priceAttr.validate(19.99);
+         * if (result.success) {
+         *     console.log('Valid:', result.data);
+         * } else {
+         *     console.log('Invalid:', result.error);
+         * }
+         * ```
+         */
+        this.validate = async (data) => {
+            return this.field.safeParseAsync(data);
+        };
+        this.setModel = (model) => {
+            let currentModel = this.getModel();
+            model = Object.assign(currentModel || {}, model);
+            this.model = model;
+            this.defaultValue = model.config.defaultValue;
+        };
+        // TODO: Better define config
+        this.getType = (type) => {
+            if (this.checkTypeValidity(type)) {
+                return type;
+            }
+            else
+                throw Error("Invalid attribute type: " + type);
+            // return this?
+        };
+        /**
+         * Returns an empty/default value for this attribute.
+         * Uses the Zod schema's default value if configured.
+         * @returns Object with attribute name as key and default/null value
+         */
+        this.getEmpty = () => {
+            const partialDoc = {
+                [this.name]: this.field.parse(undefined) || null
+            };
+            return partialDoc;
+        };
+        // getType()
+        /**
+         * Returns the attribute name.
+         * @returns The attribute name string
+         */
+        this.getName = () => {
+            return this.name;
+        };
+        this.checkTypeValidity = (type) => {
+            let validity = false;
+            if (ATTRIBUTE_TYPES.includes(type)) {
+                validity = true;
+            }
+            return validity;
+        };
+        // TODO: change to imported const default configs for types
+        // as of now it accepts only string
+        // TODO: since config depends on attribute's type, 
+        // find a way to check if given configs are correct
+        // find a way to add default configs base on type
+        this.getTypeConf = (type, config) => {
+            switch (type) {
+                // TODO: add missing cases and change values to imported const 
+                case "decimal":
+                    config = Object.assign({ max: null, min: null, precision: null, isArray: false }, config);
+                    break;
+                case "integer":
+                    config = Object.assign({ max: null, min: null, isArray: false }, config);
+                    break;
+                case "string":
+                    config = Object.assign({ isArray: false }, config);
+                    break;
+                case "object":
+                    config = Object.assign({ isArray: false }, config);
+                    break;
+                case "date":
+                    config = Object.assign({ format: "iso", max: null, min: null, isArray: false }, config);
+                    break;
+                case "boolean":
+                    config = Object.assign({ defaultValue: false, isArray: false }, config);
+                    break;
+                case "foreign_key":
+                    config = Object.assign({ targetClass: null, isArray: false }, config);
+                    break;
+                case "enum":
+                    config = Object.assign({ values: [], isArray: false }, config);
+                    break;
+                case "reference":
+                    config = Object.assign({ isArray: false }, config);
+                    break;
+                default:
+                    throw new Error("Unexpected type: " + type);
+                // return "^[a-zA-Z0-9_\\s]".concat("{0,"+config.maxLength+"}$");
+            }
+            return config;
+        };
+        this.name = name;
+        this.description = description;
+        this.setModel({
+            name: this.name,
+            description: this.description,
+            type: this.getType(type),
+            config: this.getTypeConf(type, config) || {},
+        });
+        this.setField();
+        this.class = classObj;
+    }
+    /**
+     * Creates a new Attribute and persists it to the parent Class.
+     * This is the primary factory method for creating attributes.
+     *
+     * @param classObj - The parent Class to add the attribute to
+     * @param name - The attribute name
+     * @param type - The attribute type
+     * @param description - Optional description
+     * @param config - Type-specific configuration
+     * @returns The created Attribute instance
+     *
+     * @example
+     * ```typescript
+     * const priceAttr = await Attribute.create(productClass, 'price', 'decimal', 'Product price', {
+     *     min: 0,
+     *     precision: 2,
+     *     mandatory: true
+     * });
+     * ```
+     */
+    static async create(classObj, name, type, description, config) {
+        const attribute = new _a(classObj, name, type, description, config);
+        await attribute.ensureReferenceConfigIsValid();
+        await _a.build(attribute);
+        return attribute;
+    }
+}
+_a = Attribute;
+/**
+ * Adds an attribute to its parent class and persists to the database.
+ * Used internally by {@link Attribute.create}.
+ *
+ * @param attributeObj - The Attribute instance to build
+ * @returns The Attribute instance
+ * @throws Error if the class has no stack connection
+ */
+Attribute.build = async (attributeObj) => {
+    let classObj = attributeObj.getClass();
+    let stack = classObj.getStack();
+    if (stack) {
+        await classObj.addAttribute(attributeObj);
+        return attributeObj;
+    }
+    else {
+        throw new Error("Missing db configuration");
+    }
+};
+export default Attribute;
+//# sourceMappingURL=attribute.js.map

package/lib/core/attribute.js.map

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

package/lib/core/class.d.ts

@@ -1,10 +1,9 @@
 import { Class as Class_, TriggerModel } from "@docstack/shared";
-import { ClassModel, AttributeModel, Document } from "@docstack/shared";
+import { Stack, ClassModel, Attribute as Attribute_, AttributeModel, Document } from "@docstack/shared";
 import Attribute from "./attribute";
 import { Logger } from 'winston';
 import { Trigger } from "./trigger/index";
 import { z } from "zod";
-import ClientStack from "./stack";
 /**
  * Represents a data class (schema definition) in the DocStack database.
  *
@@ -31,7 +30,7 @@ import ClientStack from "./stack";
  */
 declare class Class extends Class_ {
     /** Reference to the parent stack instance. */
-    stack: ClientStack | undefined;
+    stack: Stack | undefined;
     /** The name of this class (e.g., 'Task', 'User'). */
     name: string;
     /** The class type (e.g., 'class', '~self'). */
@@ -58,7 +57,7 @@ declare class Class extends Class_ {
     triggers: Trigger[];
     private constructor();
     build: () => Promise<Class>;
-    init: (stack: ClientStack | null, id: string, name: string, type: ClassModel["~class"], description?: string, schema?: ClassModel["schema"]) => void;
+    init: (stack: Stack | null, id: string, name: string, type: ClassModel["~class"], description?: string, schema?: ClassModel["schema"]) => void;
     /**
      * Gets a Class instance without persisting it to the database.
      * Use this for working with existing class models or for testing.
@@ -72,7 +71,7 @@ declare class Class extends Class_ {
      * @param schema - Initial schema definition
      * @returns A new Class instance (not persisted)
      */
-    static get: (stack: ClientStack, id: string, name: string, type: ClassModel["~class"], description?: string, schema?: ClassModel["schema"]) => Class;
+    static get: (stack: Stack, id: string, name: string, type: ClassModel["~class"], description?: string, schema?: ClassModel["schema"]) => Class;
     /**
      * Creates a new class and persists it to the database.
      * This is the primary factory method for creating new classes.
@@ -89,7 +88,7 @@ declare class Class extends Class_ {
      * const userClass = await Class.create(stack, 'User', 'class', 'Application users');
      * ```
      */
-    static create: (stack: ClientStack, name: string, type: ClassModel["~class"], description?: string, schema?: ClassModel["schema"]) => Promise<Class>;
+    static create: (stack: Stack, name: string, type: ClassModel["~class"], description?: string, schema?: ClassModel["schema"]) => Promise<Class>;
     /**
      * Builds a Class instance from an existing ClassModel document.
      * Hydrates attributes and triggers from the model.
@@ -98,7 +97,7 @@ declare class Class extends Class_ {
      * @param classModel - The ClassModel document from the database
      * @returns The hydrated Class instance
      */
-    static buildFromModel: (stack: ClientStack, classModel: ClassModel) => Promise<Class>;
+    static buildFromModel: (stack: Stack, classModel: ClassModel) => Promise<Class>;
     /**
      * Fetches a class by its document ID.
      *
@@ -107,7 +106,7 @@ declare class Class extends Class_ {
      * @returns The Class instance
      * @throws Error if the class is not found
      */
-    static fetchById: (stack: ClientStack, classId: string) => Promise<Class>;
+    static fetchById: (stack: Stack, classId: string) => Promise<Class>;
     /**
      * Fetches a class by its name.
      * This is the most common way to retrieve an existing class.
@@ -124,7 +123,7 @@ declare class Class extends Class_ {
      * }
      * ```
      */
-    static fetch: (stack: ClientStack, className: string) => Promise<Class>;
+    static fetch: (stack: Stack, className: string) => Promise<Class>;
     uniqueCheck: (doc: Document) => Promise<boolean>;
     bulkUniqueCheck: (pKs: string[]) => Promise<boolean>;
     /**
@@ -138,10 +137,10 @@ declare class Class extends Class_ {
     }) => Promise<boolean>;
     setId: (id: string) => void;
     getName: () => string;
-    getStack: () => ClientStack;
-    getDescription: () => string;
-    getType: () => "~self" | "class";
-    getId: () => string;
+    getStack: () => Stack | undefined;
+    getDescription: () => string | undefined;
+    getType: () => "class" | "~self";
+    getId: () => string | undefined;
     /**
      * Builds the schema object from the current attributes.
      * @returns The schema definition object
@@ -184,7 +183,7 @@ declare class Class extends Class_ {
      * // Or use Attribute.create() for a simpler API
      * ```
      */
-    addAttribute: (attribute: Attribute | AttributeModel) => Promise<Class>;
+    addAttribute: (attribute: Attribute_ | AttributeModel) => Promise<Class>;
     /**
      * Modifies an existing attribute in the class schema.
      *
@@ -192,7 +191,7 @@ declare class Class extends Class_ {
      * @param attribute - The new Attribute or AttributeModel definition
      * @returns This Class instance for chaining
      */
-    modifyAttribute: (name: string, attribute: Attribute | AttributeModel) => Promise<Class>;
+    modifyAttribute: (name: string, attribute: Attribute_ | AttributeModel) => Promise<Class>;
     /**
      * Removes an attribute from the class schema.
      *
@@ -216,7 +215,7 @@ declare class Class extends Class_ {
      */
     addCard: (params: {
         [key: string]: any;
-    }) => Promise<Document>;
+    }) => Promise<Document | null>;
     /**
      * Creates multiple documents (cards) of this class type in a batch.
      *