@stacksjs/orm 0.72.16 → 0.72.18

package/dist/models/Activity.ts

@@ -0,0 +1,95 @@
+import { defineModel } from '@stacksjs/orm'
+import { schema } from '@stacksjs/validation'
+
+export default defineModel({
+  name: 'Activity',
+  table: 'activities',
+  primaryKey: 'id',
+  autoIncrement: true,
+
+  traits: {
+    useUuid: true,
+    useTimestamps: true,
+    useSeeder: {
+      count: 50,
+    },
+    useApi: {
+      uri: 'activities',
+      routes: ['index', 'show'],
+      middleware: ['auth'],
+    },
+  },
+
+  belongsTo: ['User'],
+
+  attributes: {
+    type: {
+      required: true,
+      fillable: true,
+      validation: {
+        rule: schema.string().max(50),
+      },
+      factory: faker => faker.helpers.arrayElement([
+        'user.created', 'user.updated', 'user.deleted',
+        'order.created', 'order.completed', 'order.cancelled',
+        'product.created', 'product.updated', 'product.deleted',
+        'post.published', 'comment.approved', 'login.success',
+        'login.failed', 'subscription.renewed', 'payment.received',
+      ]),
+    },
+
+    description: {
+      required: true,
+      fillable: true,
+      validation: {
+        rule: schema.string().max(500),
+      },
+      factory: faker => faker.lorem.sentence(),
+    },
+
+    subjectType: {
+      required: false,
+      fillable: true,
+      validation: {
+        rule: schema.string().max(100),
+      },
+      factory: faker => faker.helpers.arrayElement(['User', 'Order', 'Product', 'Post', 'Comment', 'Subscription']),
+    },
+
+    subjectId: {
+      required: false,
+      fillable: true,
+      validation: {
+        rule: schema.number(),
+      },
+      factory: faker => faker.number.int({ min: 1, max: 100 }),
+    },
+
+    causer: {
+      required: false,
+      fillable: true,
+      validation: {
+        rule: schema.string().max(100),
+      },
+      factory: faker => faker.person.fullName(),
+    },
+
+    properties: {
+      required: false,
+      fillable: true,
+      validation: {
+        rule: schema.string(),
+      },
+      factory: () => JSON.stringify({ ip: '192.168.1.1', browser: 'Chrome' }),
+    },
+
+    ipAddress: {
+      required: false,
+      fillable: true,
+      validation: {
+        rule: schema.string().max(45),
+      },
+      factory: faker => faker.internet.ip(),
+    },
+  },
+} as const)

package/dist/models/AnalyticsEvent.ts

@@ -0,0 +1,70 @@
+import { defineModel } from '@stacksjs/orm'
+import { schema } from '@stacksjs/validation'
+
+export default defineModel({
+  name: 'AnalyticsEvent',
+  table: 'analytics_events',
+  primaryKey: 'id',
+  autoIncrement: true,
+
+  traits: {
+    useUuid: true,
+    useTimestamps: true,
+    useApi: {
+      uri: 'analytics-events',
+      routes: ['index', 'store', 'show', 'destroy'],
+      middleware: ['auth'],
+    },
+    observe: true,
+  },
+
+  attributes: {
+    name: {
+      required: true,
+      fillable: true,
+      validation: {
+        rule: schema.string().required().max(100),
+      },
+    },
+
+    category: {
+      required: true,
+      fillable: true,
+      default: 'custom',
+      validation: {
+        rule: schema.string().required().max(50),
+      },
+    },
+
+    path: {
+      fillable: true,
+      validation: {
+        rule: schema.string().max(2048),
+      },
+    },
+
+    value: {
+      fillable: true,
+      default: 0,
+      validation: {
+        rule: schema.number().min(0),
+      },
+    },
+
+    currency: {
+      required: true,
+      fillable: true,
+      default: 'USD',
+      validation: {
+        rule: schema.string().required().max(3),
+      },
+    },
+
+    properties: {
+      fillable: true,
+      validation: {
+        rule: schema.string(),
+      },
+    },
+  },
+} as const)

package/dist/models/Automation.ts

@@ -0,0 +1,23 @@
+import { defineModel } from '@stacksjs/orm'
+import { schema } from '@stacksjs/validation'
+
+export default defineModel({
+  name: 'Automation',
+  table: 'automations',
+  belongsTo: ['Team'],
+  hasMany: ['AutomationRun'],
+  traits: {
+    useUuid: true,
+    useTimestamps: true,
+    useApi: { uri: 'automations', routes: ['index', 'store', 'show', 'update', 'destroy'], middleware: ['auth', 'team'] },
+    observe: true,
+  },
+  attributes: {
+    name: { required: true, fillable: true, validation: { rule: schema.string().max(255) }, factory: faker => faker.lorem.words(3) },
+    status: { required: true, fillable: true, default: 'draft', validation: { rule: schema.enum(['draft', 'active', 'paused', 'archived']) }, factory: () => 'draft' },
+    version: { required: true, fillable: true, default: 1, validation: { rule: schema.number().min(1) }, factory: () => 1 },
+    trigger: { required: true, fillable: true, validation: { rule: schema.json() }, factory: () => JSON.stringify({ type: 'subscriber_joined' }) },
+    graph: { required: true, fillable: true, validation: { rule: schema.json() }, factory: () => JSON.stringify({ nodes: [], edges: [] }) },
+    publishedAt: { required: false, fillable: true, validation: { rule: schema.timestamp() }, factory: () => null },
+  },
+} as const)

package/dist/models/AutomationRun.ts

@@ -0,0 +1,26 @@
+import { defineModel } from '@stacksjs/orm'
+import { schema } from '@stacksjs/validation'
+
+export default defineModel({
+  name: 'AutomationRun',
+  table: 'automation_runs',
+  belongsTo: ['Team', 'Automation'],
+  traits: {
+    useUuid: true,
+    useTimestamps: true,
+    useApi: { uri: 'automation-runs', routes: ['index', 'show'], middleware: ['auth', 'team'] },
+  },
+  indexes: [{ name: 'automation_runs_idempotency_unique', columns: ['idempotency_key'], unique: true }],
+  attributes: {
+    status: { required: true, fillable: true, default: 'queued', validation: { rule: schema.enum(['queued', 'running', 'waiting', 'completed', 'failed', 'cancelled']) }, factory: () => 'queued' },
+    currentNodeId: { required: false, fillable: true, validation: { rule: schema.string().max(100) }, factory: () => null },
+    version: { required: true, fillable: true, default: 1, validation: { rule: schema.number().min(1) }, factory: () => 1 },
+    subjectType: { required: false, fillable: true, validation: { rule: schema.string().max(80) }, factory: () => 'contact' },
+    subjectId: { required: false, fillable: true, validation: { rule: schema.string().max(120) }, factory: () => null },
+    context: { required: true, fillable: true, validation: { rule: schema.json() }, factory: () => JSON.stringify({}) },
+    idempotencyKey: { required: true, fillable: true, validation: { rule: schema.string().max(255) }, factory: faker => faker.string.uuid() },
+    startedAt: { required: false, fillable: true, validation: { rule: schema.timestamp() }, factory: () => null },
+    finishedAt: { required: false, fillable: true, validation: { rule: schema.timestamp() }, factory: () => null },
+    error: { required: false, fillable: true, validation: { rule: schema.string() }, factory: () => null },
+  },
+} as const)

package/dist/models/Board.ts

@@ -0,0 +1,104 @@
+import { defineModel } from '@stacksjs/orm'
+import { schema } from '@stacksjs/validation'
+
+/**
+ * Kanban board (stacksjs/stacks#1846).
+ *
+ * A board owns columns, columns own cards, cards carry labels +
+ * assignees. The full hierarchy is exposed under the dashboard's
+ * Management section as a dev-mode surface — admins and devs see
+ * project-management boards; clients don't.
+ *
+ * Phase 1 scope: this model + read-only API + an index page listing
+ * boards. Phase 2 adds the drag-and-drop kanban view + write API.
+ */
+export default defineModel({
+  name: 'Board',
+  table: 'boards',
+  primaryKey: 'id',
+  autoIncrement: true,
+
+  traits: {
+    useUuid: true,
+    useTimestamps: true,
+    useSearch: {
+      displayable: ['id', 'name', 'description', 'createdAt'],
+      searchable: ['name', 'description'],
+      sortable: ['name', 'createdAt', 'updatedAt', 'position'],
+      filterable: ['archived'],
+    },
+
+    useSeeder: { count: 0 },
+
+    useApi: {
+      uri: 'boards',
+      routes: ['index', 'store', 'show', 'update', 'destroy'],
+      middleware: ['auth'],
+    },
+  },
+
+  hasMany: ['BoardColumn', 'Label'],
+
+  attributes: {
+    name: {
+      order: 1,
+      fillable: true,
+      validation: {
+        rule: schema.string().required().min(1).max(120),
+      },
+      factory: faker => faker.commerce.productName(),
+    },
+
+    description: {
+      order: 2,
+      fillable: true,
+      validation: {
+        rule: schema.string().max(2000),
+      },
+      factory: faker => faker.lorem.sentence(),
+    },
+
+    icon: {
+      order: 3,
+      fillable: true,
+      // SF Symbol name for the native sidebar; web sidebar falls back to a generic table icon.
+      validation: { rule: schema.string().max(80) },
+      factory: () => 'rectangle.stack.fill',
+    },
+
+    color: {
+      order: 4,
+      fillable: true,
+      // Tailwind-style hue token: stx-blue, stx-violet, etc. Free-form
+      // string; the UI maps unknown values to the default theme.
+      validation: { rule: schema.string().max(40) },
+      factory: faker => faker.helpers.arrayElement(['violet', 'blue', 'emerald', 'amber', 'rose']),
+    },
+
+    position: {
+      order: 5,
+      fillable: true,
+      // Sort order in the "Boards" index. Lower = appears first.
+      // Reflowed in bulk on reorder; defaults to "append at end" via
+      // server-side max() + 1 on create.
+      validation: { rule: schema.number().min(0) },
+      factory: faker => faker.number.int({ min: 0, max: 100 }),
+    },
+
+    archived: {
+      order: 6,
+      fillable: true,
+      // Soft-archived boards stay in the DB but drop out of the
+      // dashboard's default list view. They're recoverable via the
+      // /kanban/archived sub-page (Phase 3).
+      validation: { rule: schema.boolean() },
+      factory: () => false,
+    },
+  },
+
+  // The kanban surface has a dedicated dashboard page (`/kanban`),
+  // not the auto-derived `/models/board` viewer — the sidebar entry is
+  // hand-added in `dashboard-utils.ts` / `sidebar.ts` and points at
+  // the real page. Hiding the auto-row keeps it from double-listing.
+  dashboard: { enabled: false },
+} as const)

package/dist/models/BoardColumn.ts

@@ -0,0 +1,88 @@
+import { defineModel } from '@stacksjs/orm'
+import { schema } from '@stacksjs/validation'
+
+/**
+ * Column on a kanban board (stacksjs/stacks#1846).
+ *
+ * Each board owns an ordered list of columns ("Todo", "In Progress",
+ * "Review", "Done", …). Cards live inside columns. Column ordering
+ * within a board is driven by the `position` integer — Phase 2's drag
+ * handler reorders by setting a new `position` and reflowing siblings.
+ *
+ * Hidden from the sidebar as a standalone model row (`dashboard.enabled:
+ * false`) because columns only make sense inside a board. The dashboard
+ * surfaces them indirectly through `/kanban/[boardId]`. Direct ORM
+ * viewer access via `/models/board-column` still works for ops.
+ */
+export default defineModel({
+  name: 'BoardColumn',
+  table: 'board_columns',
+  primaryKey: 'id',
+  autoIncrement: true,
+
+  traits: {
+    useUuid: true,
+    useTimestamps: true,
+    useSearch: {
+      displayable: ['id', 'name', 'boardId', 'position'],
+      searchable: ['name'],
+      sortable: ['position', 'createdAt'],
+      filterable: ['boardId'],
+    },
+
+    useSeeder: { count: 0 },
+
+    useApi: {
+      uri: 'board-columns',
+      routes: ['index', 'store', 'show', 'update', 'destroy'],
+      middleware: ['auth'],
+    },
+  },
+
+  belongsTo: ['Board'],
+  hasMany: ['Card'],
+
+  attributes: {
+    boardId: {
+      order: 1,
+      fillable: true,
+      validation: { rule: schema.number().required() },
+      factory: () => 1,
+    },
+
+    name: {
+      order: 2,
+      fillable: true,
+      validation: { rule: schema.string().required().min(1).max(80) },
+      factory: faker => faker.helpers.arrayElement(['Todo', 'In Progress', 'Review', 'Done']),
+    },
+
+    position: {
+      order: 3,
+      fillable: true,
+      // Sort order within the parent board. Drag-reorder rewrites
+      // adjacent rows in a single transaction (Phase 2).
+      validation: { rule: schema.number().min(0) },
+      factory: faker => faker.number.int({ min: 0, max: 10 }),
+    },
+
+    cardLimit: {
+      order: 4,
+      fillable: true,
+      // WIP limit — nullable. The UI shows a warning badge when a
+      // column hits its limit but doesn't reject new cards
+      // (Phase 2/3 will decide whether the limit is hard or soft).
+      validation: { rule: schema.number().min(0) },
+      factory: () => null,
+    },
+
+    color: {
+      order: 5,
+      fillable: true,
+      validation: { rule: schema.string().max(40) },
+      factory: faker => faker.helpers.arrayElement(['slate', 'amber', 'blue', 'emerald']),
+    },
+  },
+
+  dashboard: { enabled: false },
+} as const)