@stacksjs/orm 0.70.348 → 0.70.350

package/dist/define-model.d.ts

@@ -62,6 +62,23 @@ export declare function defineModel<const TDef extends ModelDefinition>(definiti
  * vin, password hashes) into responses.
  */
 export declare function toAttrs<T = any>(value: any): T;
+/**
+ * Thrown when a direct write fails a declared `validation.rule`.
+ *
+ * Carries `status = 422` and a per-field `errors` map, matching the shape the
+ * generated REST routes already return, so a handler that catches this can
+ * respond with the same body it would have produced through auto-CRUD. It is
+ * duck-typed by `mapWriteError`, which preserves any integer `status` in
+ * 400-599 — so an over-length value now surfaces as a 422 instead of the
+ * driver's raw 22001 becoming a 500 (stacksjs/stacks#2233).
+ */
+/**
+ * Where `defineModel` keeps the definition it was handed.
+ *
+ * `Symbol.for`, so two copies of the ORM in one process still agree — the
+ * dist-only-app split makes that a real arrangement, not a hypothetical.
+ */
+export declare const MODEL_DEFINITION: unique symbol;
 /**
  * Custom caster interface for user-defined attribute transformations.
  */
@@ -69,7 +86,7 @@ export declare interface CasterInterface {
   get(value: unknown): unknown
   set(value: unknown): unknown
 }
-declare interface StacksModelDefinition extends Omit<BQBModelDefinition, 'attributes' | 'indexes' | 'traits'> {
+export declare interface StacksModelDefinition extends Omit<BQBModelDefinition, 'attributes' | 'indexes' | 'traits'> {
   name: string
   table: string
   primaryKey?: string
@@ -202,16 +219,6 @@ export type StacksModelStatic<TDef extends ModelDefinition> = OrmModelStatic<TDe
   /** Run `fn` with declared `validation.rule`s suppressed (bulk imports, backfills). */
   withoutValidation: <T>(fn: () => T | Promise<T>) => Promise<T>
 }
-/**
- * Thrown when a direct write fails a declared `validation.rule`.
- *
- * Carries `status = 422` and a per-field `errors` map, matching the shape the
- * generated REST routes already return, so a handler that catches this can
- * respond with the same body it would have produced through auto-CRUD. It is
- * duck-typed by `mapWriteError`, which preserves any integer `status` in
- * 400-599 — so an over-length value now surfaces as a 422 instead of the
- * driver's raw 22001 becoming a 500 (stacksjs/stacks#2233).
- */
 export declare class ModelValidationError extends Error {
   readonly status: number;
   readonly errors: Record<string, string[]>;

package/dist/extend-model.d.ts

@@ -0,0 +1,17 @@
+import type { StacksModelDefinition, StacksModelStatic } from './define-model';
+/**
+ * A model definition with `extension` folded into it.
+ *
+ * Exported separately from {@link extendModel} so the merge can be asserted
+ * without booting a model.
+ */
+export declare function mergeModelDefinition(base: StacksModelDefinition, extension: ModelExtension): StacksModelDefinition;
+/**
+ * Define a model that is the framework's, plus what this app adds.
+ *
+ * `base` is the framework model itself — import it, do not name it — so the
+ * app keeps inheriting fields, traits and relations added upstream.
+ */
+export declare function extendModel(base: unknown, extension: ModelExtension): StacksModelStatic<StacksModelDefinition>;
+/** What an extension may say. Everything is optional; anything absent is inherited. */
+export type ModelExtension = Partial<StacksModelDefinition>;

package/dist/index.d.ts

@@ -233,6 +233,7 @@ export * from './model-types';
 export * from './types';
 export * from './utils';
 export * from './define-model';
+export * from './extend-model';
 // Codegen for `database/types.d.ts` — augments
 // `@stacksjs/database`'s `DatabaseSchema` so `db.selectFrom(...)` gets
 // table-name autocomplete (stacksjs/stacks#1923).