@stacksjs/orm 0.72.16 → 0.72.17

package/dist/models/Forms/FormField.ts

@@ -0,0 +1,127 @@
+import { defineModel } from '@stacksjs/orm'
+import { schema } from '@stacksjs/validation'
+
+/**
+ * One field of a Form. `name` is the machine key submissions store values
+ * under; `conditions` is a show/hide rule set evaluated client-side for UX
+ * and re-evaluated server-side for correctness (a hidden required field is
+ * not required, and values for hidden fields are discarded).
+ */
+export default defineModel({
+  name: 'FormField',
+  table: 'form_fields',
+  primaryKey: 'id',
+  autoIncrement: true,
+
+  indexes: [
+    {
+      name: 'form_fields_form_name_unique',
+      columns: ['form_id', 'name'],
+      unique: true,
+    },
+  ],
+
+  traits: {
+    useTimestamps: true,
+    useApi: {
+      middleware: ['auth'],
+      uri: 'form-fields',
+      routes: ['index', 'store', 'show', 'update', 'destroy'],
+    },
+  },
+
+  belongsTo: ['Form'],
+
+  attributes: {
+    name: {
+      required: true,
+      order: 1,
+      fillable: true,
+      validation: {
+        rule: schema.string().min(1).max(64).matches(/^[a-z0-9_]+$/),
+      },
+      factory: faker => faker.lorem.word(),
+    },
+
+    label: {
+      required: true,
+      order: 2,
+      fillable: true,
+      validation: {
+        rule: schema.string().min(1).max(255),
+      },
+      factory: faker => faker.lorem.words(2),
+    },
+
+    type: {
+      required: true,
+      order: 3,
+      fillable: true,
+      validation: {
+        rule: schema.enum(['text', 'textarea', 'email', 'phone', 'select', 'checkbox', 'radio', 'date', 'file', 'currency', 'section_break'] as const),
+      },
+      factory: faker => faker.helpers.arrayElement(['text', 'email', 'select']),
+    },
+
+    required: {
+      required: false,
+      order: 4,
+      fillable: true,
+      default: false,
+      validation: {
+        rule: schema.boolean(),
+      },
+      factory: faker => faker.datatype.boolean(),
+    },
+
+    position: {
+      required: false,
+      order: 5,
+      fillable: true,
+      default: 0,
+      validation: {
+        rule: schema.number().min(0),
+      },
+      factory: faker => faker.number.int({ min: 0, max: 20 }),
+    },
+
+    width: {
+      required: false,
+      order: 6,
+      fillable: true,
+      default: 'full',
+      validation: {
+        rule: schema.enum(['full', 'half'] as const),
+      },
+      factory: () => 'full',
+    },
+
+    /**
+     * Per-type options JSON: { placeholder?, choices?: {label,value}[],
+     * min?, max?, accept?: string[], maxSizeMb?, amountCents? }
+     */
+    options: {
+      required: false,
+      order: 7,
+      fillable: true,
+      validation: {
+        rule: schema.json(),
+      },
+      factory: () => JSON.stringify({}),
+    },
+
+    /**
+     * Visibility rules JSON: { action: 'show'|'hide', logic: 'all'|'any',
+     * rules: [{ field, op, value? }] }
+     */
+    conditions: {
+      required: false,
+      order: 8,
+      fillable: true,
+      validation: {
+        rule: schema.json(),
+      },
+      factory: () => null,
+    },
+  },
+} as const)

package/dist/models/Forms/FormSubmission.ts

@@ -0,0 +1,114 @@
+import { defineModel } from '@stacksjs/orm'
+import { schema } from '@stacksjs/validation'
+
+/**
+ * One submission of a Form. `values` is the validated field map; `email` and
+ * `name` are extracted into typed columns at submit time (from the fields the
+ * form's settings name, defaulting to the first email field) so lookups,
+ * dedupe and confirmation addressing never need JSON extraction SQL.
+ *
+ * No `useApi`: public writes and admin reads both go through the
+ * `@stacksjs/forms` routes, which own spam guards, payment states and
+ * site scoping.
+ */
+export default defineModel({
+  name: 'FormSubmission',
+  table: 'form_submissions',
+  primaryKey: 'id',
+  autoIncrement: true,
+
+  traits: {
+    useUuid: true,
+    useTimestamps: true,
+  },
+
+  belongsTo: ['Form', 'Site'],
+
+  attributes: {
+    /** Validated { [fieldName]: value } JSON. Named data, not values - values is a SQL keyword. */
+    data: {
+      required: true,
+      order: 1,
+      fillable: true,
+      validation: {
+        rule: schema.json(),
+      },
+      factory: () => JSON.stringify({}),
+    },
+
+    email: {
+      required: false,
+      order: 2,
+      fillable: true,
+      validation: {
+        rule: schema.string().email().max(255),
+      },
+      factory: faker => faker.internet.email(),
+    },
+
+    name: {
+      required: false,
+      order: 3,
+      fillable: true,
+      validation: {
+        rule: schema.string().max(255),
+      },
+      factory: faker => faker.person.fullName(),
+    },
+
+    status: {
+      required: false,
+      order: 4,
+      fillable: true,
+      default: 'complete',
+      validation: {
+        rule: schema.enum(['pending_payment', 'complete', 'spam'] as const),
+      },
+      factory: () => 'complete',
+    },
+
+    /** Server-computed. Never trusted from the client. */
+    amountCents: {
+      required: false,
+      order: 5,
+      fillable: true,
+      validation: {
+        rule: schema.number().min(0),
+      },
+      factory: () => null,
+    },
+
+    paymentIntentId: {
+      required: false,
+      order: 6,
+      fillable: true,
+      validation: {
+        rule: schema.string().max(255),
+      },
+      factory: () => null,
+    },
+
+    ip: {
+      required: false,
+      order: 7,
+      fillable: true,
+      validation: {
+        rule: schema.string().max(64),
+      },
+      factory: () => null,
+    },
+
+    submittedAt: {
+      required: false,
+      order: 8,
+      fillable: true,
+      validation: {
+        rule: schema.timestamp(),
+      },
+      factory: (faker) => {
+        const date = faker.date.recent()
+        return date.toISOString().slice(0, 19).replace('T', ' ')
+      },
+    },
+  },
+} as const)

package/dist/models/Job.ts

@@ -0,0 +1,69 @@
+import { defineModel } from '@stacksjs/orm'
+import { schema } from '@stacksjs/validation'
+
+export default defineModel({
+  name: 'Job',
+  table: 'jobs',
+  primaryKey: 'id',
+  autoIncrement: true,
+
+  traits: {
+    useTimestamps: true,
+    useSeeder: {
+      count: 15,
+    },
+  },
+
+  attributes: {
+    queue: {
+      fillable: true,
+      validation: {
+        rule: schema.string().required().max(255),
+        message: {
+          max: 'Queue must have a maximum of 255 characters',
+        },
+      },
+      factory: () => 'default',
+    },
+
+    payload: {
+      fillable: true,
+      validation: {
+        rule: schema.string().required(),
+      },
+      factory: () => JSON.stringify({
+        jobName: 'ExampleJob',
+        payload: {},
+        options: { tries: 3 },
+        envelopeVersion: 1,
+        dispatchedAt: new Date().toISOString(),
+      }),
+    },
+
+    attempts: {
+      fillable: true,
+      validation: {
+        rule: schema.number(),
+        message: {
+          number: 'attempts must be a number',
+        },
+      },
+      factory: () => 0,
+    },
+
+    available_at: {
+      fillable: true,
+      validation: {
+        rule: schema.number(),
+      },
+      factory: () => Math.floor(Date.now() / 1000),
+    },
+    reserved_at: {
+      fillable: true,
+      validation: {
+        rule: schema.number(),
+      },
+      factory: () => null,
+    },
+  },
+} as const)

package/dist/models/Label.ts

@@ -0,0 +1,67 @@
+import { defineModel } from '@stacksjs/orm'
+import { schema } from '@stacksjs/validation'
+
+/**
+ * Card label / tag (stacksjs/stacks#1846).
+ *
+ * Labels are board-scoped: each board owns its own label palette
+ * (so "Bug" on board A is a different record from "Bug" on board B,
+ * with potentially different colours). Cards attach labels via the
+ * `card_labels` pivot — that wiring lands in Phase 3.
+ *
+ * Hidden from the sidebar as a standalone model row — labels are
+ * managed inside the board view, not as a top-level surface.
+ */
+export default defineModel({
+  name: 'Label',
+  table: 'labels',
+  primaryKey: 'id',
+  autoIncrement: true,
+
+  traits: {
+    useUuid: true,
+    useTimestamps: true,
+    useSearch: {
+      displayable: ['id', 'name', 'color', 'boardId'],
+      searchable: ['name'],
+      sortable: ['name', 'createdAt'],
+      filterable: ['boardId'],
+    },
+
+    useSeeder: { count: 0 },
+
+    useApi: {
+      uri: 'labels',
+      routes: ['index', 'store', 'show', 'update', 'destroy'],
+      middleware: ['auth'],
+    },
+  },
+
+  belongsTo: ['Board'],
+
+  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(60) },
+      factory: faker => faker.helpers.arrayElement(['Bug', 'Feature', 'Docs', 'Refactor', 'Urgent']),
+    },
+
+    color: {
+      order: 3,
+      fillable: true,
+      // Hue token resolved by the UI — same palette as Board.color.
+      validation: { rule: schema.string().max(40) },
+      factory: faker => faker.helpers.arrayElement(['red', 'amber', 'emerald', 'blue', 'violet', 'slate']),
+    },
+  },
+
+  dashboard: { enabled: false },
+} as const)

package/dist/models/Log.ts

@@ -0,0 +1,134 @@
+import { defineModel } from '@stacksjs/orm'
+import { schema } from '@stacksjs/validation'
+
+export default defineModel({
+  name: 'Log',
+  table: 'logs',
+  primaryKey: 'id',
+  autoIncrement: true,
+
+  indexes: [
+    {
+      name: 'logs_timestamp_index',
+      columns: ['timestamp'],
+    },
+    {
+      name: 'logs_type_timestamp_index',
+      columns: ['type', 'timestamp'],
+    },
+    {
+      name: 'logs_source_timestamp_index',
+      columns: ['source', 'timestamp'],
+    },
+    {
+      name: 'logs_project_timestamp_index',
+      columns: ['project', 'timestamp'],
+    },
+  ],
+
+  traits: {
+    useTimestamps: true,
+    useApi: {
+      uri: 'logs',
+      routes: ['index', 'show'],
+      middleware: ['auth'],
+    },
+    useSeeder: {
+      count: 50,
+    },
+    useSearch: {
+      displayable: ['id', 'type', 'source', 'message', 'project', 'timestamp'],
+      searchable: ['message', 'project', 'file'],
+      sortable: ['timestamp', 'type', 'source'],
+      filterable: ['type', 'source', 'project'],
+    },
+  },
+
+  attributes: {
+    timestamp: {
+      order: 1,
+      fillable: true,
+      validation: {
+        rule: schema.number().required(),
+        message: {
+          date: 'Timestamp must be a valid date',
+        },
+      },
+      factory: faker => faker.date.recent().getTime(),
+    },
+
+    type: {
+      order: 2,
+      fillable: true,
+      validation: {
+        rule: schema.enum(['warning', 'error', 'info', 'success']).required(),
+        message: {
+          enum: 'Type must be one of: warning, error, info, success',
+        },
+      },
+      factory: faker => faker.helpers.arrayElement(['warning', 'error', 'info', 'success']),
+    },
+
+    source: {
+      order: 3,
+      fillable: true,
+      validation: {
+        rule: schema.enum(['file', 'cli', 'system']).required(),
+        message: {
+          enum: 'Source must be one of: file, cli, system',
+        },
+      },
+      factory: faker => faker.helpers.arrayElement(['file', 'cli', 'system']),
+    },
+
+    message: {
+      order: 4,
+      fillable: true,
+      validation: {
+        rule: schema.string().required().min(1).max(1000),
+        message: {
+          min: 'Message must not be empty',
+          max: 'Message must not exceed 1000 characters',
+        },
+      },
+      factory: faker => faker.lorem.sentence(),
+    },
+
+    project: {
+      order: 5,
+      fillable: true,
+      validation: {
+        rule: schema.string().min(1).required().max(255),
+        message: {
+          min: 'Project name must not be empty',
+          max: 'Project name must not exceed 255 characters',
+        },
+      },
+      factory: faker => faker.company.name(),
+    },
+
+    stacktrace: {
+      order: 6,
+      fillable: true,
+      validation: {
+        rule: schema.string().required().max(5000),
+        message: {
+          max: 'Stacktrace must not exceed 5000 characters',
+        },
+      },
+      factory: faker => faker.lorem.paragraphs(2),
+    },
+
+    file: {
+      order: 7,
+      fillable: true,
+      validation: {
+        rule: schema.string().required().max(255),
+        message: {
+          max: 'File path must not exceed 255 characters',
+        },
+      },
+      factory: faker => faker.system.filePath().substring(0, 255),
+    },
+  },
+} as const)

package/dist/models/MagicLinkToken.ts

@@ -0,0 +1,97 @@
+import { defineModel } from '@stacksjs/orm'
+import { schema } from '@stacksjs/validation'
+
+/**
+ * A single-use passwordless sign-in token. `token` stores the SHA-256 of the
+ * raw value - deterministic, so consume is one indexed lookup, and with 256
+ * bits of entropy in the raw token an offline attack on a fast hash is
+ * irrelevant (deliberately NOT the bcrypt-and-scan of password resets).
+ *
+ * No `useApi`: these rows are written and consumed by the auth flow only.
+ */
+export default defineModel({
+  name: 'MagicLinkToken',
+  table: 'magic_link_tokens',
+  primaryKey: 'id',
+  autoIncrement: true,
+
+  indexes: [
+    {
+      name: 'magic_link_tokens_token_unique',
+      columns: ['token'],
+      unique: true,
+    },
+  ],
+
+  traits: {
+    useTimestamps: true,
+  },
+
+  belongsTo: ['User'],
+
+  attributes: {
+    email: {
+      required: true,
+      order: 1,
+      fillable: true,
+      validation: {
+        rule: schema.string().email().max(255),
+      },
+      factory: faker => faker.internet.email(),
+    },
+
+    /** SHA-256 hex of the raw token. Never the raw value. */
+    token: {
+      required: true,
+      order: 2,
+      fillable: true,
+      unique: true,
+      validation: {
+        rule: schema.string().min(64).max(64),
+      },
+      factory: faker => faker.string.hexadecimal({ length: 64, prefix: '' }).toLowerCase(),
+    },
+
+    expiresAt: {
+      required: true,
+      order: 3,
+      fillable: true,
+      validation: {
+        rule: schema.timestamp(),
+      },
+      factory: () => new Date(Date.now() + 15 * 60_000).toISOString().slice(0, 19).replace('T', ' '),
+    },
+
+    consumedAt: {
+      required: false,
+      order: 4,
+      fillable: true,
+      validation: {
+        rule: schema.timestamp(),
+      },
+      factory: () => null,
+    },
+
+    /** Relative path the consumed link lands on. Validated relative-only. */
+    redirectTo: {
+      required: false,
+      order: 5,
+      fillable: true,
+      validation: {
+        rule: schema.string().max(2048),
+      },
+      factory: () => null,
+    },
+
+    /** The site whose primary host the link targets, on multi-site apps. */
+    siteId: {
+      required: false,
+      order: 6,
+      fillable: true,
+      validation: {
+        rule: schema.number().min(1),
+      },
+      factory: () => null,
+    },
+  },
+} as const)