spine-framework 0.1.0

package/dist/src/types/types.d.ts

@@ -0,0 +1,364 @@
+/**
+ * @module src/types/types
+ * @audience installer
+ * @layer frontend-hook
+ * @stability stable
+ *
+ * Core TypeScript type definitions for the Spine frontend. These types
+ * mirror the `design_schema` and API response shapes used across hooks,
+ * components, and pages.
+ *
+ * **Type hierarchy:**
+ * ```
+ * DesignSchema
+ *   ├── fields: Record<string, FieldDefinition>
+ *   ├── views: Record<string, View>   ← ListView | DetailView
+ *   ├── record_permissions
+ *   └── functionality?: FunctionalityBindings
+ * ItemType  ← row in v2.types table
+ * Item       ← row in v2.items table
+ * ```
+ *
+ * **`system` flag on `FieldDefinition`:** When `system: true`, the field
+ * maps to a real DB column (e.g. `title`, `status`). When absent or false,
+ * the field value lives in the `data` JSONB column.
+ *
+ * @seeAlso src/hooks/useSchemaRecord.ts (consumes FieldDefinition[])
+ * @seeAlso src/hooks/useForm.ts (consumes FieldDefinition[] for validation)
+ * @seeAlso src/hooks/useListSchema.ts (consumes DesignSchema + View)
+ * @seeAlso functions/_shared/schema-utils.ts (server-side schema generation)
+ */
+/**
+ * Definition of a single field in a `design_schema`. Drives both UI rendering
+ * and client-side validation in `useForm`.
+ *
+ * @prop data_type - Controls rendering widget and validation rules
+ * @prop label - Human-readable display label
+ * @prop required - Whether the field must be non-empty on save
+ * @prop system - If true, maps to a top-level DB column; false/absent → `data` JSONB
+ * @prop name - Injected at runtime by hooks; not stored in the schema itself
+ * @prop validation - Type-specific constraint overrides
+ * @prop options - Choice list for select/multiselect/radio fields
+ * @prop permissions - Role-based read/write access map; absent = all roles allowed
+ */
+export interface FieldDefinition {
+    data_type: 'text' | 'textarea' | 'rich_text' | 'email' | 'phone' | 'url' | 'number' | 'currency' | 'range' | 'date' | 'datetime' | 'boolean' | 'checkbox' | 'select' | 'multiselect' | 'radio' | 'color' | 'file' | 'image' | 'json' | 'reference' | 'address';
+    label: string;
+    required: boolean;
+    system?: boolean;
+    name?: string;
+    placeholder?: string;
+    description?: string;
+    rows?: number;
+    min?: number;
+    max?: number;
+    step?: number;
+    readonly?: boolean;
+    disabled?: boolean;
+    validation?: {
+        pattern?: string;
+        minLength?: number;
+        maxLength?: number;
+        min?: number;
+        max?: number;
+        step?: number;
+        integer?: boolean;
+        precision?: number;
+        maxSize?: number;
+        allowedTypes?: string[];
+        maxWidth?: number;
+        maxHeight?: number;
+        currency_code?: string;
+        reference_kind?: string;
+        reference_type?: string;
+    };
+    options?: (string | {
+        value: string;
+        label: string;
+    })[];
+    permissions?: {
+        [role: string]: string[];
+    };
+}
+/**
+ * Per-field display/behaviour config within a view. Stored as
+ * `design_schema.views[viewSlug].fields[fieldName]`.
+ *
+ * @prop display_type - Override the default widget for this field in this view
+ * @prop sortable - Whether the column header shows a sort toggle in list views
+ * @prop searchable - Whether the field is included in free-text search
+ */
+export interface ViewFieldConfig {
+    display_type: 'input' | 'textarea' | 'rich_text' | 'select' | 'multiselect' | 'radio' | 'checkbox' | 'switch' | 'date_picker' | 'datetime_picker' | 'color_picker' | 'file_upload' | 'image_upload' | 'range_slider' | 'rating' | 'autocomplete' | 'address_form' | 'reference_picker' | 'text' | 'badge' | 'timestamp' | 'currency' | 'number';
+    sortable?: boolean;
+    searchable?: boolean;
+}
+/**
+ * A list view definition. Rendered by `DataListPage` as a table, card grid,
+ * or Kanban board depending on `display`.
+ *
+ * @prop fields - Ordered map of field name → `ViewFieldConfig`
+ * @prop default_sort - Initial sort applied before user interaction
+ * @prop filters - Field names to expose as filter controls
+ * @prop stats - Summary stat cards shown above the list
+ * @prop group_by - Field to use as board column grouping (`display: 'board'` only)
+ */
+export interface ListView {
+    type: 'list';
+    display: 'table' | 'card' | 'board';
+    label: string;
+    fields: Record<string, ViewFieldConfig>;
+    default_sort?: {
+        field: string;
+        direction: 'asc' | 'desc';
+    };
+    filters?: string[];
+    stats?: Array<{
+        title: string;
+        type: 'count' | 'filter_count';
+        icon?: string;
+        color?: string;
+        filter?: Record<string, any>;
+    }>;
+    group_by?: string;
+}
+/**
+ * A single section within a `DetailView`. Groups related fields under
+ * an optional title. Field permissions from the schema still apply —
+ * there are no section-level permission overrides.
+ */
+export interface DetailViewSection {
+    title: string;
+    fields: Record<string, ViewFieldConfig>;
+}
+/**
+ * A detail view definition. Rendered by `DataDetailPage` as a sectioned
+ * record form.
+ */
+export interface DetailView {
+    type: 'detail';
+    label: string;
+    sections: DetailViewSection[];
+}
+/** Discriminated union of all supported view types. */
+export type View = ListView | DetailView;
+/**
+ * Optional automation and integration bindings attached to a `DesignSchema`.
+ * Each array entry describes a trigger condition and the target pipeline,
+ * agent, embedding, integration, or constraint.
+ *
+ * These bindings are evaluated by API handlers and the system cron — not
+ * by the frontend. They are included here as a type contract so the frontend
+ * can read and display binding metadata without making blind `any` casts.
+ */
+export interface FunctionalityBindings {
+    pipelines?: Array<{
+        pipeline_id: string;
+        trigger: 'manual' | 'on_create' | 'on_update' | 'on_field_change' | 'on_delete' | 'scheduled';
+        field?: string;
+        condition?: string;
+        roles: string[];
+    }>;
+    ai_agents?: Array<{
+        agent_id: string;
+        capabilities: ('read' | 'summarize' | 'suggest' | 'update')[];
+        trigger: 'manual' | 'on_create' | 'on_update' | 'on_field_change';
+        roles: string[];
+    }>;
+    embeddings?: Array<{
+        slug: string;
+        fields: string[];
+        model: string;
+        vector_column: string;
+        trigger: 'on_create' | 'on_update' | 'on_create_or_update';
+    }>;
+    integrations?: Array<{
+        integration_id: string;
+        sync: 'bidirectional' | 'inbound' | 'outbound';
+        field_map: Record<string, {
+            external_field: string;
+            direction: 'both' | 'inbound' | 'outbound' | 'none';
+            transform?: string;
+        }>;
+        trigger: 'on_create' | 'on_update' | 'on_create_or_update';
+    }>;
+    constraints?: Array<{
+        type: 'unique' | 'conditional_required' | 'immutable';
+        fields?: string[];
+        field?: string;
+        condition?: string;
+        message: string;
+        after?: 'create' | 'update';
+    }>;
+}
+/**
+ * The complete design schema for a `types` record. Stored as a JSONB column
+ * (`design_schema`) and stamp-copied onto records at create time.
+ *
+ * @prop record_permissions - Role → allowed CRUD actions map for the entire record
+ * @prop fields - All field definitions keyed by field name
+ * @prop views - Named view definitions (`list`, `detail`, etc.)
+ * @prop functionality - Optional automation bindings (pipelines, agents, etc.)
+ */
+export interface DesignSchema {
+    record_permissions: {
+        [role: string]: string[];
+    };
+    fields: Record<string, FieldDefinition>;
+    views: Record<string, View>;
+    functionality?: FunctionalityBindings;
+}
+/**
+ * A row from the `v2.types` table. Represents a type definition (item type,
+ * account type, person type, etc.) including its full `design_schema`.
+ *
+ * @prop kind - Discriminator: `'item'` | `'account'` | `'person'` | etc.
+ * @prop design_schema - Full schema defining fields, views, and functionality
+ * @prop validation_schema - Auto-generated JSON Schema used for server-side validation
+ * @prop ownership - `'pack'` | `'tenant'` (pack-ownership tracking)
+ */
+export interface ItemType {
+    id: string;
+    name: string;
+    slug: string;
+    kind: string;
+    description?: string;
+    icon?: string;
+    color?: string;
+    design_schema: DesignSchema;
+    validation_schema: {
+        fields: Record<string, {
+            data_type: string;
+            required?: boolean;
+            [key: string]: any;
+        }>;
+    };
+    ownership: string;
+    is_active: boolean;
+    app_id?: string;
+    app?: any;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * A row from the `v2.items` table. The `data` JSONB column holds all
+ * custom field values; system fields (`title`, `status`, etc.) are top-level.
+ *
+ * @prop design_schema - Stamp of the type's schema at create time (for resilience
+ *   to schema changes; may be stale relative to `types` table)
+ * @prop validation_schema - Stamp of the validation schema at create time
+ */
+export interface Item {
+    id: string;
+    item_type_id: string;
+    item_type_slug?: string;
+    title: string;
+    description?: string;
+    status: string;
+    is_active: boolean;
+    data: Record<string, any>;
+    created_at: string;
+    updated_at: string;
+    created_by?: string;
+    account_id: string;
+    app_id?: string;
+    design_schema?: Record<string, any>;
+    validation_schema?: Record<string, any>;
+}
+/** A field-level validation failure from `useForm` or server-side validation. */
+export interface ValidationError {
+    field: string;
+    message: string;
+}
+/** Snapshot of form state — used as a shared type between `useForm` and form components. */
+export interface FormState {
+    data: Record<string, any>;
+    errors: Record<string, string>;
+    touched: Record<string, boolean>;
+    isSubmitting: boolean;
+    isValid: boolean;
+}
+/** Pagination query parameters for list endpoints. */
+export interface PaginationParams {
+    limit?: number;
+    offset?: number;
+    page?: number;
+}
+/** Sort order specification for list endpoints. */
+export interface SortParams {
+    field: string;
+    direction: 'asc' | 'desc';
+}
+/** Arbitrary key→value filter map for list endpoints. */
+export interface FilterParams {
+    [key: string]: any;
+}
+/** Combined search, sort, filter, and pagination params for list queries. */
+export interface SearchParams extends PaginationParams {
+    search?: string;
+    sort?: SortParams;
+    filters?: FilterParams;
+}
+/** A rendered column descriptor for list/table UI components. */
+export interface EntityColumn {
+    key: string;
+    label: string;
+    sortable?: boolean;
+    type?: string;
+    display_type?: string;
+    badgeColors?: Record<string, string>;
+    maxLength?: number;
+}
+/** A stat card shown above entity list pages (count or filtered count). */
+export interface EntityStat {
+    title: string;
+    type: 'count' | 'filter_count';
+    icon: string;
+    color: string;
+    filter?: Record<string, any>;
+}
+/** A filter control definition for entity list pages. */
+export interface EntityFilter {
+    key: string;
+    label: string;
+    type: 'search' | 'enum' | 'boolean';
+    options?: string[];
+}
+/**
+ * A per-person, per-item progress record. Tracks pipeline status, score, and
+ * arbitrary interaction data for courses, onboarding, tasks, and quizzes.
+ *
+ * `title` is auto-composed as "<item title> — <person name>".
+ * `description` is auto-composed as "Completed · score 85 · 2 attempts".
+ * `data` holds extensible fields: attempts, time_spent, last_position, etc.
+ *
+ * INVARIANT: (person_id, item_id) is unique — state, not a log.
+ */
+export interface ItemProgress {
+    id: string;
+    type_id: string;
+    account_id: string;
+    app_id: string | null;
+    person_id: string;
+    item_id: string;
+    title: string | null;
+    description: string | null;
+    status: 'not_started' | 'in_progress' | 'completed' | string;
+    score: number | null;
+    data: {
+        attempts?: number;
+        time_spent?: number;
+        last_position?: number;
+        started_at?: string;
+        completed_at?: string;
+        [key: string]: any;
+    };
+    is_active: boolean;
+    design_schema: Record<string, any>;
+    validation_schema: Record<string, any>;
+    created_by: string | null;
+    updated_by: string | null;
+    created_at: string;
+    updated_at: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types/types.d.ts.map

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

package/package.json

@@ -0,0 +1,192 @@
+{
+  "name": "spine-framework",
+  "version": "0.1.0",
+  "private": false,
+  "description": "Spine — enterprise application framework built on Supabase + Netlify + React",
+  "type": "module",
+  "license": "MIT",
+  "keywords": ["spine", "framework", "supabase", "netlify", "react", "enterprise", "agentic"],
+  "homepage": "https://github.com/art-mojo-admin/spine#readme",
+  "bugs": {
+    "url": "https://github.com/art-mojo-admin/spine/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/art-mojo-admin/spine"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "bin": {
+    "spine-framework": "./.framework/cli/bin.cjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/functions/_shared/index.d.ts",
+      "import": "./.framework/functions/_shared/index.ts"
+    },
+    "./_shared": {
+      "types": "./dist/functions/_shared/index.d.ts",
+      "import": "./.framework/functions/_shared/index.ts"
+    },
+    "./_shared/*": {
+      "types": "./dist/functions/_shared/*.d.ts",
+      "import": "./.framework/functions/_shared/*.ts"
+    },
+    "./cli": {
+      "types": "./dist/cli/index.d.ts",
+      "import": "./.framework/cli/index.ts"
+    }
+  },
+  "files": [
+    "dist/",
+    ".framework/cli/bin.cjs",
+    ".framework/cli/welcome.cjs",
+    ".framework/cli/",
+    ".framework/functions/",
+    ".framework/migrations/",
+    ".framework/docs/",
+    ".framework/src/",
+    "scripts/",
+    "config/",
+    "STRUCTURE.md",
+    "README.md"
+  ],
+  "scripts": {
+    "spine-framework": "tsx .framework/cli/index.ts",
+    "dev": "vite --config config/vite.config.ts",
+    "assemble": "bash scripts/assemble.sh",
+    "assemble:frontend": "bash scripts/assemble-frontend.sh",
+    "assemble:functions": "bash scripts/assemble-functions.sh",
+    "manifest": "bash scripts/build-manifest.sh",
+    "verify": "bash scripts/verify-integrity.sh",
+    "prebuild": "npm run assemble && npm run verify",
+    "build": "tsc -b config/tsconfig.json && vite build --config config/vite.config.ts",
+    "build:lib": "tsc -p config/tsconfig.build.json",
+    "prepublishOnly": "npm run build:lib && npm run test:boundary && npm run test:unit",
+    "preview": "vite preview --config config/vite.config.ts",
+    "lint": "eslint .",
+    "app-install": "tsx scripts/app-install-cli.ts",
+    "load-test": "tsx scripts/load-test-app-install.ts",
+    "test": "vitest run",
+    "test:unit": "vitest run .framework/tests/unit",
+    "test:core": "vitest run .framework/tests/unit/core-isolation.test.ts",
+    "test:integration": "vitest run .framework/tests/integration",
+    "test:boundary": "bash scripts/boundary-check.sh",
+    "test:custom": "vitest run custom/tests",
+    "postinstall": "node -e \"try{require('./.framework/cli/welcome.cjs')}catch(e){}\"",
+    "docs": "typedoc --config config/typedoc.json"
+  },
+  "dependencies": {
+    "@supabase/supabase-js": "^2.49.1",
+    "commander": "^12.0.0",
+    "jsonwebtoken": "^9.0.3",
+    "jwt-decode": "^4.0.0",
+    "tsx": "^4.21.0"
+  },
+  "peerDependencies": {
+    "@netlify/functions": "^2.0.0",
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0",
+    "react-router-dom": "^6.0.0",
+    "vite": "^5.0.0 || ^6.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@netlify/functions": { "optional": false },
+    "react": { "optional": false },
+    "react-dom": { "optional": false },
+    "react-router-dom": { "optional": false },
+    "vite": { "optional": true }
+  },
+  "devDependencies": {
+    "@base-ui/react": "^1.4.1",
+    "@fontsource-variable/inter": "^5.2.8",
+    "@heroicons/react": "^2.2.0",
+    "@netlify/functions": "^2.8.2",
+    "@radix-ui/react-accordion": "^1.2.12",
+    "@radix-ui/react-avatar": "^1.1.3",
+    "@radix-ui/react-dialog": "^1.1.6",
+    "@radix-ui/react-dropdown-menu": "^2.1.6",
+    "@radix-ui/react-icons": "^1.3.2",
+    "@radix-ui/react-label": "^2.1.2",
+    "@radix-ui/react-popover": "^1.1.6",
+    "@radix-ui/react-select": "^2.1.6",
+    "@radix-ui/react-separator": "^1.1.2",
+    "@radix-ui/react-slider": "^1.3.6",
+    "@radix-ui/react-slot": "^1.1.2",
+    "@radix-ui/react-switch": "^1.1.3",
+    "@radix-ui/react-tabs": "^1.1.3",
+    "@radix-ui/react-toast": "^1.2.6",
+    "@radix-ui/react-tooltip": "^1.1.8",
+    "@supabase/supabase-js": "^2.49.1",
+    "@tailwindcss/typography": "^0.5.19",
+    "@tanstack/react-query": "^5.95.2",
+    "@tiptap/extension-code-block-lowlight": "^3.20.0",
+    "@tiptap/extension-image": "^3.20.0",
+    "@tiptap/extension-link": "^3.20.0",
+    "@tiptap/extension-placeholder": "^3.20.0",
+    "@tiptap/extension-table": "^3.20.0",
+    "@tiptap/extension-table-cell": "^3.20.0",
+    "@tiptap/extension-table-header": "^3.20.0",
+    "@tiptap/extension-table-row": "^3.20.0",
+    "@tiptap/extension-youtube": "^3.20.0",
+    "@tiptap/pm": "^3.20.0",
+    "@tiptap/react": "^3.20.0",
+    "@tiptap/starter-kit": "^3.20.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.12.0",
+    "@types/react": "^18.3.18",
+    "@types/react-dom": "^18.3.5",
+    "@types/react-grid-layout": "^1.3.6",
+    "@vitejs/plugin-react": "^4.3.4",
+    "@xyflow/react": "^12.10.1",
+    "ajv": "^8.12.0",
+    "autoprefixer": "^10.4.20",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "cmdk": "^1.1.1",
+    "dagre": "^0.8.5",
+    "date-fns": "^4.1.0",
+    "embla-carousel-react": "^8.6.0",
+    "framer-motion": "^12.34.3",
+    "github-markdown-css": "^5.9.0",
+    "highlight.js": "^11.11.1",
+    "input-otp": "^1.4.2",
+    "js-yaml": "^4.1.0",
+    "lowlight": "^3.3.0",
+    "lucide-react": "^1.14.0",
+    "marked": "^17.0.3",
+    "mermaid": "^11.12.3",
+    "next-themes": "^0.4.6",
+    "postcss": "^8.5.1",
+    "radix-ui": "^1.4.3",
+    "react": "^18.3.1",
+    "react-day-picker": "^10.0.0",
+    "react-dom": "^18.3.1",
+    "react-grid-layout": "^2.2.2",
+    "react-is": "^19.2.4",
+    "react-markdown": "^10.1.0",
+    "react-refresh": "^0.14.0",
+    "react-resizable-panels": "^4.11.0",
+    "react-router-dom": "^6.28.1",
+    "recharts": "3.8.0",
+    "rehype-autolink-headings": "^7.1.0",
+    "rehype-raw": "^7.0.0",
+    "rehype-sanitize": "^6.0.0",
+    "rehype-slug": "^6.0.0",
+    "remark-gfm": "^4.0.1",
+    "shadcn": "^4.7.0",
+    "sonner": "^2.0.7",
+    "tailwind-merge": "^3.5.0",
+    "tailwindcss": "^3.4.17",
+    "tailwindcss-animate": "^1.0.7",
+    "tiptap-markdown": "^0.9.0",
+    "tw-animate-css": "^1.4.0",
+    "typedoc": "^0.27.0",
+    "typescript": "~5.6.2",
+    "vaul": "^1.1.2",
+    "vite": "^6.0.11",
+    "vitest": "^2.1.9"
+  },
+  "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"
+}