@jaypie/fabric 0.1.0

package/dist/esm/types/elementaryTypes.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Elementary Field Types
+ *
+ * Defines the 10 elementary field types for the Fabric vocabulary.
+ * Each type has: alias, name, icon, and optional validation/format rules.
+ */
+import type { FieldDefinition } from "./fieldDefinition.js";
+/** Elementary type aliases */
+export declare const ELEMENTARY_TYPES: readonly ["boolean", "date", "datetime", "dollars", "multiselect", "number", "reference", "select", "text", "textarea"];
+export type ElementaryType = (typeof ELEMENTARY_TYPES)[number];
+/**
+ * Extended field definition for elementary types
+ */
+export interface ElementaryTypeDefinition extends FieldDefinition {
+    /** The elementary type alias */
+    alias: ElementaryType;
+    /** Display format pattern */
+    formatPattern?: string;
+    /** Input component type (for UI rendering) */
+    inputComponent?: string;
+    /** Options for select/multiselect types */
+    options?: Array<{
+        label: string;
+        value: string;
+    }>;
+    /** Reference model for reference types */
+    referenceModel?: string;
+}
+/**
+ * Check if a string is an elementary type
+ */
+export declare function isElementaryType(value: unknown): value is ElementaryType;
+/**
+ * Boolean - True/false toggle
+ */
+export declare const BOOLEAN_TYPE: ElementaryTypeDefinition;
+/**
+ * Date - Date picker (ISO format)
+ */
+export declare const DATE_TYPE: ElementaryTypeDefinition;
+/**
+ * Datetime - Date + time picker
+ */
+export declare const DATETIME_TYPE: ElementaryTypeDefinition;
+/**
+ * Dollars - Currency with formatting
+ */
+export declare const DOLLARS_TYPE: ElementaryTypeDefinition;
+/**
+ * Multiselect - Multiple selections from options
+ */
+export declare const MULTISELECT_TYPE: ElementaryTypeDefinition;
+/**
+ * Number - Numeric input (integer or float)
+ */
+export declare const NUMBER_TYPE: ElementaryTypeDefinition;
+/**
+ * Reference - Link to another model
+ */
+export declare const REFERENCE_TYPE: ElementaryTypeDefinition;
+/**
+ * Select - Single selection from options
+ */
+export declare const SELECT_TYPE: ElementaryTypeDefinition;
+/**
+ * Text - Single-line string input
+ */
+export declare const TEXT_TYPE: ElementaryTypeDefinition;
+/**
+ * Textarea - Multi-line string input
+ */
+export declare const TEXTAREA_TYPE: ElementaryTypeDefinition;
+/**
+ * Registry of all elementary types
+ */
+export declare const ELEMENTARY_TYPE_REGISTRY: Record<ElementaryType, ElementaryTypeDefinition>;
+/**
+ * Get an elementary type definition by alias
+ */
+export declare function getElementaryType(alias: ElementaryType): ElementaryTypeDefinition;
+/**
+ * Get all elementary type definitions
+ */
+export declare function getAllElementaryTypes(): ElementaryTypeDefinition[];

package/dist/esm/types/fieldCategory.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Field Categories - Semantic classification of fields
+ *
+ * Categories define the semantic boundary of fields within models.
+ */
+/** Field categories defining semantic boundaries */
+export declare const FIELD_CATEGORIES: readonly ["identity", "input", "metadata", "state"];
+/**
+ * Field category - semantic classification of fields
+ *
+ * - identity: What the model IS (immutable) - id, model, ou
+ * - metadata: What the model is ABOUT (usually immutable) - alias, xid, class, type
+ * - state: What the model TRACKS (mutable) - content, status, progress
+ * - input: Request parameters (transient) - data, params, options
+ */
+export type FieldCategory = (typeof FIELD_CATEGORIES)[number];
+/**
+ * Check if a string is a valid field category
+ */
+export declare function isFieldCategory(value: unknown): value is FieldCategory;

package/dist/esm/types/fieldDefinition.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Field Definition - Describes a field's structure and behavior
+ *
+ * Field definitions are the building blocks of model definitions,
+ * specifying type, validation, and metadata for each field.
+ */
+/**
+ * Validation rule for a field
+ */
+export interface ValidationRule {
+    /** Error message if validation fails */
+    message?: string;
+    /** Rule type (required, min, max, pattern, etc.) */
+    type: string;
+    /** Rule value (varies by type) */
+    value?: unknown;
+}
+/**
+ * Field definition - describes a field's structure and behavior
+ */
+export interface FieldDefinition {
+    /** Field identifier (unique within model) */
+    alias: string;
+    /** Default value */
+    defaultValue?: unknown;
+    /** Description */
+    description?: string;
+    /** Fallback chain for value resolution */
+    fallback?: string[];
+    /** Icon (lucide name or custom) */
+    icon?: string;
+    /** Display name */
+    name: string;
+    /** Field type (text, number, dollars, etc.) */
+    type: string;
+    /** Validation rules */
+    validation?: ValidationRule[];
+}
+/**
+ * Field reference - either an alias string or inline definition
+ */
+export type FieldRef = FieldDefinition | string;
+/**
+ * Check if a field ref is an inline definition
+ */
+export declare function isFieldDefinition(ref: FieldRef): ref is FieldDefinition;

package/dist/esm/types/index.d.ts

@@ -0,0 +1,4 @@
+export { BOOLEAN_TYPE, DATE_TYPE, DATETIME_TYPE, DOLLARS_TYPE, ELEMENTARY_TYPE_REGISTRY, ELEMENTARY_TYPES, getAllElementaryTypes, getElementaryType, isElementaryType, MULTISELECT_TYPE, NUMBER_TYPE, REFERENCE_TYPE, SELECT_TYPE, TEXT_TYPE, TEXTAREA_TYPE, } from "./elementaryTypes.js";
+export type { ElementaryType, ElementaryTypeDefinition, } from "./elementaryTypes.js";
+export { isFieldDefinition } from "./fieldDefinition.js";
+export type { FieldDefinition, FieldRef, ValidationRule, } from "./fieldDefinition.js";

package/dist/esm/types.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Log levels for messages
+ * @default "info"
+ */
+export type MessageLevel = "debug" | "error" | "info" | "trace" | "warn";
+/**
+ * Standard message structure for callbacks and notifications
+ */
+export interface Message {
+    content: string;
+    level?: MessageLevel;
+}
+export type ScalarType = typeof Boolean | typeof Number | typeof String | "boolean" | "number" | "string";
+export type CompositeType = typeof Array | typeof Object | "array" | "object";
+export type ArrayElementType = typeof Boolean | typeof Number | typeof Object | typeof String | "boolean" | "number" | "object" | "string" | "" | Record<string, never>;
+export type TypedArrayType = [] | [typeof Boolean] | [typeof Number] | [typeof Object] | [typeof String] | ["boolean"] | ["number"] | ["object"] | ["string"] | [""] | [Record<string, never>];
+export type ValidatedStringType = Array<string | RegExp>;
+export type ValidatedNumberType = Array<number>;
+export type RegExpType = RegExp;
+export type DateConversionType = typeof Date;
+export type ConversionType = CompositeType | DateConversionType | RegExpType | ScalarType | TypedArrayType | ValidatedNumberType | ValidatedStringType;
+export interface InputFieldDefinition {
+    default?: unknown;
+    description?: string;
+    /** Override the long flag name for Commander.js (e.g., "user" for --user) */
+    flag?: string;
+    /** Short switch letter for Commander.js (e.g., "u" for -u) */
+    letter?: string;
+    required?: boolean;
+    type: ConversionType;
+    validate?: ValidateFunction | RegExp | Array<unknown>;
+}
+export type ValidateFunction = (value: unknown) => boolean | void | Promise<boolean | void>;
+/**
+ * Context passed to service functions for callbacks and utilities
+ */
+export interface ServiceContext {
+    /** Report a recoverable error during service execution (does not throw) */
+    onError?: (error: unknown) => void | Promise<void>;
+    /** Report a fatal error during service execution (does not throw) */
+    onFatal?: (error: unknown) => void | Promise<void>;
+    /** Send a message during service execution (connects to onMessage callback) */
+    sendMessage?: (message: Message) => void | Promise<void>;
+}
+export type ServiceFunction<TInput, TOutput> = (input: TInput, context?: ServiceContext) => TOutput | Promise<TOutput>;
+export interface ServiceConfig<TInput extends Record<string, unknown> = Record<string, unknown>, TOutput = unknown> {
+    alias?: string;
+    description?: string;
+    input?: Record<string, InputFieldDefinition>;
+    service?: ServiceFunction<TInput, TOutput>;
+}
+export interface Service<TInput extends Record<string, unknown> = Record<string, unknown>, TOutput = unknown> extends ServiceConfig<TInput, TOutput> {
+    (input?: Partial<TInput> | string, context?: ServiceContext): Promise<TOutput>;
+    /** Fabric version identifier - used to detect pre-instantiated Services */
+    $fabric?: string;
+}

package/package.json

@@ -0,0 +1,122 @@
+{
+  "name": "@jaypie/fabric",
+  "version": "0.1.0",
+  "description": "Jaypie modeling framework with type conversion, service handlers, and adapters",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/finlaysonstudio/jaypie.git"
+  },
+  "license": "MIT",
+  "author": "Finlayson Studio",
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.cjs"
+    },
+    "./commander": {
+      "types": "./dist/esm/commander/index.d.ts",
+      "import": "./dist/esm/commander/index.js",
+      "require": "./dist/cjs/commander/index.cjs"
+    },
+    "./http": {
+      "types": "./dist/esm/http/index.d.ts",
+      "import": "./dist/esm/http/index.js",
+      "require": "./dist/cjs/http/index.cjs"
+    },
+    "./lambda": {
+      "types": "./dist/esm/lambda/index.d.ts",
+      "import": "./dist/esm/lambda/index.js",
+      "require": "./dist/cjs/lambda/index.cjs"
+    },
+    "./llm": {
+      "types": "./dist/esm/llm/index.d.ts",
+      "import": "./dist/esm/llm/index.js",
+      "require": "./dist/cjs/llm/index.cjs"
+    },
+    "./mcp": {
+      "types": "./dist/esm/mcp/index.d.ts",
+      "import": "./dist/esm/mcp/index.js",
+      "require": "./dist/cjs/mcp/index.cjs"
+    },
+    "./express": {
+      "types": "./dist/esm/express/index.d.ts",
+      "import": "./dist/esm/express/index.js",
+      "require": "./dist/cjs/express/index.cjs"
+    },
+    "./data": {
+      "types": "./dist/esm/data/index.d.ts",
+      "import": "./dist/esm/data/index.js",
+      "require": "./dist/cjs/data/index.cjs"
+    }
+  },
+  "main": "./dist/cjs/index.cjs",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rollup --config",
+    "format": "eslint . --fix",
+    "lint": "eslint .",
+    "test": "vitest run .",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@jaypie/errors": "^1.2.1"
+  },
+  "devDependencies": {
+    "@jaypie/testkit": "*",
+    "@modelcontextprotocol/sdk": "^1.17.0",
+    "@rollup/plugin-typescript": "^12.1.2",
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.13.1",
+    "@typescript-eslint/eslint-plugin": "^8.18.2",
+    "@typescript-eslint/parser": "^8.18.2",
+    "commander": "^12.1.0",
+    "eslint-config-prettier": "^10.0.1",
+    "eslint-plugin-prettier": "^5.2.1",
+    "eslint-plugin-vitest": "^0.5.4",
+    "express": "^5.0.1",
+    "jest-extended": "^7.0.0",
+    "rollup": "^4.12.0",
+    "typescript": "^5.3.3",
+    "typescript-eslint": "^8.18.2",
+    "vitest": "^3.0.5"
+  },
+  "peerDependencies": {
+    "@jaypie/aws": "*",
+    "@jaypie/dynamodb": "*",
+    "@jaypie/lambda": "*",
+    "@modelcontextprotocol/sdk": ">=1.0.0",
+    "commander": ">=12.0.0",
+    "express": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@jaypie/aws": {
+      "optional": true
+    },
+    "@jaypie/dynamodb": {
+      "optional": true
+    },
+    "@jaypie/lambda": {
+      "optional": true
+    },
+    "@modelcontextprotocol/sdk": {
+      "optional": true
+    },
+    "commander": {
+      "optional": true
+    },
+    "express": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}