@tailor-platform/sdk 1.69.0 → 1.70.0

package/dist/{workflow.generated-Br9bmLdX.d.mts → workflow.generated-DJULCuRr.d.mts}

@@ -1,6 +1,6 @@
 import { c as TailorUser, i as InferredAttributeMap } from "./types-DTcZ2Yax.mjs";
-import { A as Validators, D as TailorField, E as FieldValidateInput, F as output, P as Prettify, S as EnumValue, T as FieldOutput, a as Hooks, b as ArrayFieldOutput, g as TailorDBType$1, h as TailorDBServiceInput, i as Hook, j as InferFieldsOutput, k as TailorToTs, l as RelationType, n as DefinedDBFieldMetadata, o as IndexDef, p as TailorDBField$1, r as ExcludeNestedDBFields, t as DBFieldMetadata, u as SerialConfig, v as TypeFeatures, w as FieldOptions } from "./types-DZrtN6-H.mjs";
-import { it as BuiltinIdP, o as PluginConfigs, z as AuthConfig } from "./types-Bzr0RQME.mjs";
+import { A as Validators, E as FieldValidateInput, F as output, O as TailorFieldType, P as TypeLevelError, S as EnumValue, T as FieldOutput, a as Hooks, g as TailorDBType$1, h as TailorDBServiceInput, i as Hook, j as InferFieldsOutput, k as TailorToTs, l as RelationType, n as DefinedDBFieldMetadata, o as IndexDef, p as TailorDBField$1, r as ExcludeNestedDBFields, t as DBFieldMetadata, u as SerialConfig, v as TypeFeatures, w as FieldOptions } from "./types-rj8YJcEe.mjs";
+import { it as BuiltinIdP, o as PluginConfigs, z as AuthConfig } from "./types-Dynq4AJv.mjs";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/configure/types/field.d.ts
@@ -126,8 +126,138 @@ declare const unsafeAllowAllTypePermission: TailorTypePermission;
 declare const unsafeAllowAllGqlPermission: TailorTypeGqlPermission;
 //#endregion
 //#region src/configure/services/tailordb/schema.d.ts
-type TailorAnyDBField = TailorDBField<any, any>;
+type AnyBuilderMethod = any;
+type TailorAnyDBField = Omit<TailorDBField$1<AnyBuilderMethod, AnyBuilderMethod>, "fields"> & {
+  readonly fields: Record<string, AnyBuilderMethod>;
+  _metadata: DBFieldMetadata;
+  parse: AnyBuilderMethod;
+  _parseInternal: AnyBuilderMethod;
+  readonly typeName: TypeLevelError<string>;
+  description: AnyBuilderMethod;
+  relation: AnyBuilderMethod;
+  index: AnyBuilderMethod;
+  unique: AnyBuilderMethod;
+  vector: AnyBuilderMethod;
+  hooks: AnyBuilderMethod;
+  validate: AnyBuilderMethod;
+  serial: AnyBuilderMethod;
+  clone: AnyBuilderMethod;
+};
 type TailorAnyDBType = TailorDBType<any, any>;
+type IsAny<T> = 0 extends 1 & T ? true : false;
+type DBFieldTypeNameMethod<Defined extends DefinedDBFieldMetadata> = IsAny<Defined> extends true ? TypeLevelError<string> : TypeLevelError<"typeName cannot be used on TailorDB fields">;
+type WithDBFieldDescription<Defined> = Defined & {
+  description: true;
+};
+type WithDBFieldRelation<Defined, S extends RelationType | RelationSelfConfig> = S extends "oneToOne" | "1-1" ? Defined & {
+  unique: true;
+  index: true;
+  relation: true;
+} : S extends {
+  type: "oneToOne" | "1-1";
+} ? Defined & {
+  unique: true;
+  index: true;
+  relation: true;
+} : Defined & {
+  index: true;
+  relation: true;
+};
+type WithDBFieldIndex<Defined> = Defined & {
+  index: true;
+};
+type WithDBFieldUnique<Defined> = Defined & {
+  unique: true;
+  index: true;
+};
+type WithDBFieldVector<Defined> = Defined & {
+  vector: true;
+};
+type WithDBFieldHooks<Defined, H> = Defined & {
+  hooks: {
+    create: H extends {
+      create: unknown;
+    } ? true : false;
+    update: H extends {
+      update: unknown;
+    } ? true : false;
+  };
+  serial: false;
+};
+type WithDBFieldValidate<Defined> = Defined & {
+  validate: true;
+};
+type WithDBFieldSerial<Defined> = Defined & {
+  serial: true;
+  hooks: {
+    create: false;
+    update: false;
+  };
+};
+type WithDBFieldCloneOptions<Defined extends DefinedDBFieldMetadata, NewOpt extends FieldOptions> = Omit<Defined, "array"> & {
+  array: NewOpt extends {
+    array: true;
+  } ? true : Defined["array"];
+};
+type FileKeyConflictError<Fields extends Record<string, TailorAnyDBField>, User extends object> = Partial<Record<keyof output<TailorDBType<Fields, User>> & string, TypeLevelError<"file keys cannot use existing field names">>>;
+type DBFieldDescriptionFn<Defined extends DefinedDBFieldMetadata, Output> = (description: string) => TailorDBField<WithDBFieldDescription<Defined>, Output>;
+type DBFieldRelationFn<Defined extends DefinedDBFieldMetadata, Output> = {
+  <S extends RelationType, T extends TailorAnyDBType>(config: RelationConfig<S, T>): TailorDBField<WithDBFieldRelation<Defined, S>, Output>;
+  <S extends RelationSelfConfig>(config: S): TailorDBField<WithDBFieldRelation<Defined, S>, Output>;
+};
+type DBFieldIndexFn<Defined extends DefinedDBFieldMetadata, Output> = () => TailorDBField<WithDBFieldIndex<Defined>, Output>;
+type DBFieldUniqueFn<Defined extends DefinedDBFieldMetadata, Output> = () => TailorDBField<WithDBFieldUnique<Defined>, Output>;
+type DBFieldVectorFn<Defined extends DefinedDBFieldMetadata, Output> = () => TailorDBField<WithDBFieldVector<Defined>, Output>;
+type DBFieldHooksFn<Defined extends DefinedDBFieldMetadata, Output> = <const H extends Hook<unknown, Output>>(hooks: H) => TailorDBField<WithDBFieldHooks<Defined, H>, Output>;
+type DBFieldValidateFn<Defined extends DefinedDBFieldMetadata, Output> = (...validate: FieldValidateInput<Output>[]) => TailorDBField<WithDBFieldValidate<Defined>, Output>;
+type DBFieldSerialFn<Defined extends DefinedDBFieldMetadata, Output> = (config: SerialConfig<Defined["type"] & ("integer" | "string")>) => TailorDBField<WithDBFieldSerial<Defined>, Output>;
+type DBFieldDescriptionMethod<Defined extends DefinedDBFieldMetadata, Output> = IsAny<Defined> extends true ? DBFieldDescriptionFn<Defined, Output> : Defined extends {
+  description: unknown;
+} ? TypeLevelError<".description() has already been set"> : DBFieldDescriptionFn<Defined, Output>;
+type DBFieldRelationMethod<Defined extends DefinedDBFieldMetadata, Output> = IsAny<Defined> extends true ? DBFieldRelationFn<Defined, Output> : Defined extends {
+  relation: unknown;
+} ? TypeLevelError<".relation() has already been set"> : DBFieldRelationFn<Defined, Output>;
+type DBFieldIndexMethod<Defined extends DefinedDBFieldMetadata, Output> = IsAny<Defined> extends true ? DBFieldIndexFn<Defined, Output> : Defined extends {
+  index: unknown;
+} ? TypeLevelError<".index() has already been set"> : Defined extends {
+  array: true;
+} ? TypeLevelError<"index cannot be set on array fields"> : DBFieldIndexFn<Defined, Output>;
+type DBFieldUniqueMethod<Defined extends DefinedDBFieldMetadata, Output> = IsAny<Defined> extends true ? DBFieldUniqueFn<Defined, Output> : Defined extends {
+  unique: unknown;
+} ? TypeLevelError<".unique() has already been set"> : Defined extends {
+  array: true;
+} ? TypeLevelError<"unique cannot be set on array fields"> : DBFieldUniqueFn<Defined, Output>;
+type DBFieldVectorMethod<Defined extends DefinedDBFieldMetadata, Output> = IsAny<Defined> extends true ? DBFieldVectorFn<Defined, Output> : Defined extends {
+  vector: unknown;
+} ? TypeLevelError<".vector() has already been set"> : Defined extends {
+  type: "string";
+  array: false;
+} ? DBFieldVectorFn<Defined, Output> : TypeLevelError<"vector can only be set on non-array string fields">;
+type DBFieldHooksMethod<Defined extends DefinedDBFieldMetadata, Output> = IsAny<Defined> extends true ? DBFieldHooksFn<Defined, Output> : Defined extends {
+  serial: true;
+  hooks: {
+    create: false;
+    update: false;
+  };
+} ? TypeLevelError<"hooks cannot be set after serial"> : Defined extends {
+  hooks: unknown;
+} ? TypeLevelError<".hooks() has already been set"> : Defined extends {
+  type: "nested";
+} ? TypeLevelError<"hooks cannot be set on nested type fields"> : DBFieldHooksFn<Defined, Output>;
+type DBFieldValidateMethod<Defined extends DefinedDBFieldMetadata, Output> = IsAny<Defined> extends true ? DBFieldValidateFn<Defined, Output> : Defined extends {
+  validate: unknown;
+} ? TypeLevelError<".validate() has already been set"> : DBFieldValidateFn<Defined, Output>;
+type DBFieldSerialMethod<Defined extends DefinedDBFieldMetadata, Output> = IsAny<Defined> extends true ? DBFieldSerialFn<Defined, Output> : Defined extends {
+  serial: true;
+} ? TypeLevelError<".serial() has already been set"> : Defined extends {
+  serial: false;
+} ? TypeLevelError<"serial cannot be set after hooks"> : IsAny<Output> extends true ? Defined extends {
+  type: "integer" | "string";
+  array: false;
+} ? DBFieldSerialFn<Defined, Output> : TypeLevelError<"serial can only be set on non-array integer or string fields"> : null extends Output ? TypeLevelError<"serial can only be set on non-array integer or string fields"> : Defined extends {
+  type: "integer" | "string";
+  array: false;
+} ? DBFieldSerialFn<Defined, Output> : TypeLevelError<"serial can only be set on non-array integer or string fields">;
 /**
  * Full TailorDBField interface with builder methods.
  * Extends the minimal structural interface from types/ with fluent API methods.
@@ -148,122 +278,43 @@ interface TailorDBField<Defined extends DefinedDBFieldMetadata = DefinedDBFieldM
    * typeName is not available on TailorDB fields.
    * Use typeName on pipeline fields (t.enum / t.object) instead.
    */
-  typeName(this: never, typeName: string): never;
+  typeName: DBFieldTypeNameMethod<Defined>;
   /**
    * Set a description for the field
    */
-  description<CurrentDefined extends Defined>(this: CurrentDefined extends {
-    description: unknown;
-  } ? never : TailorField<CurrentDefined, Output>, description: string): TailorDBField<Prettify<CurrentDefined & {
-    description: true;
-  }>, Output>;
+  description: DBFieldDescriptionMethod<Defined, Output>;
   /**
    * Define a relation to another type.
    */
-  relation<S extends RelationType, T extends TailorAnyDBType, CurrentDefined extends Defined>(this: CurrentDefined extends {
-    relation: unknown;
-  } ? never : TailorDBField<CurrentDefined, Output>, config: RelationConfig<S, T>): TailorDBField<S extends "oneToOne" | "1-1" ? Prettify<CurrentDefined & {
-    unique: true;
-    index: true;
-    relation: true;
-  }> : Prettify<CurrentDefined & {
-    index: true;
-    relation: true;
-  }>, Output>;
-  /**
-   * Define a self-referencing relation
-   */
-  relation<S extends RelationSelfConfig, CurrentDefined extends Defined>(this: CurrentDefined extends {
-    relation: unknown;
-  } ? never : TailorDBField<CurrentDefined, Output>, config: S): TailorDBField<S["type"] extends "oneToOne" | "1-1" ? Prettify<CurrentDefined & {
-    unique: true;
-    index: true;
-    relation: true;
-  }> : Prettify<CurrentDefined & {
-    index: true;
-    relation: true;
-  }>, Output>;
+  relation: DBFieldRelationMethod<Defined, Output>;
   /**
    * Add an index to the field
    */
-  index<CurrentDefined extends Defined>(this: CurrentDefined extends {
-    index: unknown;
-  } ? never : CurrentDefined extends {
-    array: true;
-  } ? never : TailorDBField<CurrentDefined, Output>): TailorDBField<Prettify<CurrentDefined & {
-    index: true;
-  }>, Output>;
+  index: DBFieldIndexMethod<Defined, Output>;
   /**
    * Make the field unique (also adds an index)
    */
-  unique<CurrentDefined extends Defined>(this: CurrentDefined extends {
-    unique: unknown;
-  } ? never : CurrentDefined extends {
-    array: true;
-  } ? never : TailorDBField<CurrentDefined, Output>): TailorDBField<Prettify<CurrentDefined & {
-    unique: true;
-    index: true;
-  }>, Output>;
+  unique: DBFieldUniqueMethod<Defined, Output>;
   /**
    * Enable vector search on the field (string type only)
    */
-  vector<CurrentDefined extends Defined>(this: CurrentDefined extends {
-    vector: unknown;
-  } ? never : CurrentDefined extends {
-    type: "string";
-    array: false;
-  } ? TailorDBField<CurrentDefined, Output> : never): TailorDBField<Prettify<CurrentDefined & {
-    vector: true;
-  }>, Output>;
+  vector: DBFieldVectorMethod<Defined, Output>;
   /**
    * Add hooks for create/update operations on this field.
    */
-  hooks<CurrentDefined extends Defined, const H extends Hook<unknown, Output>>(this: CurrentDefined extends {
-    hooks: unknown;
-  } ? never : CurrentDefined extends {
-    type: "nested";
-  } ? never : TailorDBField<CurrentDefined, Output>, hooks: H): TailorDBField<Prettify<CurrentDefined & {
-    hooks?: {
-      create: H extends {
-        create: unknown;
-      } ? true : false;
-      update: H extends {
-        update: unknown;
-      } ? true : false;
-    };
-    serial: false;
-  }>, Output>;
+  hooks: DBFieldHooksMethod<Defined, Output>;
   /**
    * Add validation functions to the field.
    */
-  validate<CurrentDefined extends Defined>(this: CurrentDefined extends {
-    validate: unknown;
-  } ? never : TailorDBField<CurrentDefined, Output>, ...validate: FieldValidateInput<Output>[]): TailorDBField<Prettify<CurrentDefined & {
-    validate: true;
-  }>, Output>;
+  validate: DBFieldValidateMethod<Defined, Output>;
   /**
    * Configure serial/auto-increment behavior
    */
-  serial<CurrentDefined extends Defined>(this: CurrentDefined extends {
-    serial: unknown;
-  } ? never : Output extends null ? never : CurrentDefined extends {
-    type: "integer" | "string";
-    array: false;
-  } ? TailorDBField<CurrentDefined, Output> : never, config: SerialConfig<CurrentDefined["type"] & ("integer" | "string")>): TailorDBField<Prettify<CurrentDefined & {
-    serial: true;
-    hooks: {
-      create: false;
-      update: false;
-    };
-  }>, Output>;
+  serial: DBFieldSerialMethod<Defined, Output>;
   /**
    * Clone the field with optional overrides for field options
    */
-  clone<const NewOpt extends FieldOptions>(options?: NewOpt): TailorDBField<Prettify<Omit<Defined, "array"> & {
-    array: NewOpt extends {
-      array: true;
-    } ? true : Defined["array"];
-  }>, FieldOutput<TailorToTs[Defined["type"]], NewOpt>>;
+  clone<const NewOpt extends FieldOptions>(options?: NewOpt): TailorDBField<WithDBFieldCloneOptions<Defined, NewOpt>, FieldOutput<TailorToTs[Defined["type"]], NewOpt>>;
 }
 /**
  * Full TailorDBType interface with builder methods.
@@ -275,7 +326,7 @@ interface TailorDBType<Fields extends Record<string, TailorAnyDBField> = any, Us
   validate(validators: Validators<Fields>): TailorDBType<Fields, User>;
   features(features: Omit<TypeFeatures, "pluralForm">): TailorDBType<Fields, User>;
   indexes(...indexes: IndexDef<TailorDBType<Fields, User>>[]): TailorDBType<Fields, User>;
-  files<const F extends string>(files: Record<F, string> & Partial<Record<keyof output<TailorDBType<Fields, User>>, never>>): TailorDBType<Fields, User>;
+  files<const F extends string>(files: Record<F, string> & FileKeyConflictError<Fields, User>): TailorDBType<Fields, User>;
   permission<U extends object = User, P extends TailorTypePermission<U, output<TailorDBType<Fields, User>>> = TailorTypePermission<U, output<TailorDBType<Fields, User>>>>(permission: P): TailorDBType<Fields, U>;
   gqlPermission<U extends object = User, P extends TailorTypeGqlPermission<U> = TailorTypeGqlPermission<U>>(permission: P): TailorDBType<Fields, U>;
   description(description: string): TailorDBType<Fields, User>;
@@ -318,6 +369,14 @@ type FieldParseInternalArgs = {
   user: TailorUser;
   pathArray: string[];
 };
+type DBFieldDefined<T extends TailorFieldType, Opt extends FieldOptions> = {
+  type: T;
+  array: Opt extends {
+    array: true;
+  } ? true : false;
+};
+type DBFieldOutput<T extends TailorFieldType, Opt extends FieldOptions, OutputBase = TailorToTs[T]> = FieldOutput<OutputBase, Opt>;
+type TailorDBFieldInstance<T extends TailorFieldType, Opt extends FieldOptions, OutputBase = TailorToTs[T]> = TailorDBField<DBFieldDefined<T, Opt>, DBFieldOutput<T, Opt, OutputBase>>;
 /**
  * Create a UUID field.
  * @param options - Field configuration options
@@ -325,12 +384,7 @@ type FieldParseInternalArgs = {
  * @example db.uuid()
  * @example db.uuid({ optional: true })
  */
-declare function uuid<const Opt extends FieldOptions>(options?: Opt): TailorDBField<{
-  type: "uuid";
-  array: Opt extends {
-    array: true;
-  } ? true : false;
-}, Opt["optional"] extends true ? ArrayFieldOutput<string, Opt> | null : ArrayFieldOutput<string, Opt>>;
+declare function uuid<const Opt extends FieldOptions>(options?: Opt): TailorDBFieldInstance<"uuid", Opt, string>;
 /**
  * Create a string field.
  * @param options - Field configuration options
@@ -338,12 +392,7 @@ declare function uuid<const Opt extends FieldOptions>(options?: Opt): TailorDBFi
  * @example db.string()
  * @example db.string({ optional: true })
  */
-declare function string<const Opt extends FieldOptions>(options?: Opt): TailorDBField<{
-  type: "string";
-  array: Opt extends {
-    array: true;
-  } ? true : false;
-}, Opt["optional"] extends true ? ArrayFieldOutput<string, Opt> | null : ArrayFieldOutput<string, Opt>>;
+declare function string<const Opt extends FieldOptions>(options?: Opt): TailorDBFieldInstance<"string", Opt, string>;
 /**
  * Create a boolean field.
  * Note: The method name is `bool` but creates a `boolean` type field.
@@ -352,12 +401,7 @@ declare function string<const Opt extends FieldOptions>(options?: Opt): TailorDB
  * @example db.bool()
  * @example db.bool({ optional: true })
  */
-declare function bool<const Opt extends FieldOptions>(options?: Opt): TailorDBField<{
-  type: "boolean";
-  array: Opt extends {
-    array: true;
-  } ? true : false;
-}, Opt["optional"] extends true ? ArrayFieldOutput<boolean, Opt> | null : ArrayFieldOutput<boolean, Opt>>;
+declare function bool<const Opt extends FieldOptions>(options?: Opt): TailorDBFieldInstance<"boolean", Opt, boolean>;
 /**
  * Create an integer field.
  * @param options - Field configuration options
@@ -365,12 +409,7 @@ declare function bool<const Opt extends FieldOptions>(options?: Opt): TailorDBFi
  * @example db.int()
  * @example db.int({ optional: true })
  */
-declare function int<const Opt extends FieldOptions>(options?: Opt): TailorDBField<{
-  type: "integer";
-  array: Opt extends {
-    array: true;
-  } ? true : false;
-}, Opt["optional"] extends true ? ArrayFieldOutput<number, Opt> | null : ArrayFieldOutput<number, Opt>>;
+declare function int<const Opt extends FieldOptions>(options?: Opt): TailorDBFieldInstance<"integer", Opt, number>;
 /**
  * Create a float (decimal number) field.
  * @param options - Field configuration options
@@ -378,12 +417,7 @@ declare function int<const Opt extends FieldOptions>(options?: Opt): TailorDBFie
  * @example db.float()
  * @example db.float({ optional: true })
  */
-declare function float<const Opt extends FieldOptions>(options?: Opt): TailorDBField<{
-  type: "float";
-  array: Opt extends {
-    array: true;
-  } ? true : false;
-}, Opt["optional"] extends true ? ArrayFieldOutput<number, Opt> | null : ArrayFieldOutput<number, Opt>>;
+declare function float<const Opt extends FieldOptions>(options?: Opt): TailorDBFieldInstance<"float", Opt, number>;
 interface DecimalFieldOptions extends FieldOptions {
   scale?: number;
 }
@@ -395,12 +429,7 @@ interface DecimalFieldOptions extends FieldOptions {
  * @example db.decimal({ scale: 2 })
  * @example db.decimal({ scale: 2, optional: true })
  */
-declare function decimal<const Opt extends DecimalFieldOptions>(options?: Opt): TailorDBField<{
-  type: "decimal";
-  array: Opt extends {
-    array: true;
-  } ? true : false;
-}, Opt["optional"] extends true ? ArrayFieldOutput<string, Opt> | null : ArrayFieldOutput<string, Opt>>;
+declare function decimal<const Opt extends DecimalFieldOptions>(options?: Opt): TailorDBFieldInstance<"decimal", Opt, string>;
 /**
  * Create a date field (date only, no time component).
  * Format: "yyyy-MM-dd"
@@ -408,12 +437,7 @@ declare function decimal<const Opt extends DecimalFieldOptions>(options?: Opt):
  * @returns A date field
  * @example db.date()
  */
-declare function date<const Opt extends FieldOptions>(options?: Opt): TailorDBField<{
-  type: "date";
-  array: Opt extends {
-    array: true;
-  } ? true : false;
-}, Opt["optional"] extends true ? ArrayFieldOutput<string, Opt> | null : ArrayFieldOutput<string, Opt>>;
+declare function date<const Opt extends FieldOptions>(options?: Opt): TailorDBFieldInstance<"date", Opt, string>;
 /**
  * Create a datetime field (date and time).
  * Format: ISO 8601 "yyyy-MM-ddTHH:mm:ssZ"
@@ -421,12 +445,7 @@ declare function date<const Opt extends FieldOptions>(options?: Opt): TailorDBFi
  * @returns A datetime field
  * @example db.datetime()
  */
-declare function datetime<const Opt extends FieldOptions>(options?: Opt): TailorDBField<{
-  type: "datetime";
-  array: Opt extends {
-    array: true;
-  } ? true : false;
-}, Opt["optional"] extends true ? ArrayFieldOutput<string | Date, Opt> | null : ArrayFieldOutput<string | Date, Opt>>;
+declare function datetime<const Opt extends FieldOptions>(options?: Opt): TailorDBFieldInstance<"datetime", Opt, string | Date>;
 /**
  * Create a time field (time only, no date component).
  * Format: "HH:mm"
@@ -434,12 +453,7 @@ declare function datetime<const Opt extends FieldOptions>(options?: Opt): Tailor
  * @returns A time field
  * @example db.time()
  */
-declare function time<const Opt extends FieldOptions>(options?: Opt): TailorDBField<{
-  type: "time";
-  array: Opt extends {
-    array: true;
-  } ? true : false;
-}, Opt["optional"] extends true ? ArrayFieldOutput<string, Opt> | null : ArrayFieldOutput<string, Opt>>;
+declare function time<const Opt extends FieldOptions>(options?: Opt): TailorDBFieldInstance<"time", Opt, string>;
 /**
  * Create an enum field with a fixed set of allowed string values.
  * @param values - Array of allowed string values, or array of `{ value, description }` objects
@@ -468,10 +482,7 @@ declare function object<const F extends Record<string, TailorAnyDBField> & Exclu
     array: true;
   } ? true : false;
 }, FieldOutput<InferFieldsOutput<F>, Opt>>;
-declare const idField: TailorDBField<{
-  type: "uuid";
-  array: false;
-}, string>;
+declare const idField: TailorDBFieldInstance<"uuid", FieldOptions, string>;
 type idField = typeof idField;
 type DBType<F extends {
   id?: never;
@@ -537,26 +548,20 @@ declare const db: {
      * });
      */
     timestamps: () => {
-      createdAt: TailorDBField<{
-        type: "datetime";
-        array: false;
-        hooks?: {
-          create: true;
-          update: false;
-        } | undefined;
-        serial: false;
-        description: true;
-      }, string | Date>;
-      updatedAt: TailorDBField<{
-        type: "datetime";
-        array: false;
-        hooks?: {
-          create: false;
-          update: true;
-        } | undefined;
-        serial: false;
-        description: true;
-      }, string | Date | null>;
+      createdAt: TailorDBField<WithDBFieldDescription<WithDBFieldHooks<DBFieldDefined<"datetime", FieldOptions>, {
+        readonly create: ({
+          value
+        }: {
+          value: string | Date | null;
+          data: unknown;
+          user: TailorUser;
+        }) => string | Date;
+      }>>, string | Date>;
+      updatedAt: TailorDBField<WithDBFieldDescription<WithDBFieldHooks<DBFieldDefined<"datetime", {
+        readonly optional: true;
+      }>, {
+        readonly update: () => Date;
+      }>>, string | Date | null>;
     };
   };
 };
@@ -1339,4 +1344,4 @@ type ConcurrencyPolicy = {
 };
 //#endregion
 export { TailorDBInstance as A, IdPInput as C, TailorAnyDBField as D, AIGatewayInput as E, TailorTypePermission as F, unsafeAllowAllGqlPermission as I, unsafeAllowAllTypePermission as L, db as M, PermissionCondition as N, TailorAnyDBType as O, TailorTypeGqlPermission as P, AllowedValues as R, IdPGqlOperationsInput as S, AIGatewayDefinitionBrand as T, IdPConfig as _, ExecutorServiceConfig as a, IdPEmailConfig as b, ResolverServiceConfig as c, WorkflowServiceInput as d, StaticWebsiteConfig as f, SecretsDefinitionBrand as g, SecretsConfig as h, AppConfig as i, TailorDBType as j, TailorDBField as k, ResolverServiceInput as l, StaticWebsiteInput as m, RetryPolicy as n, ExecutorServiceInput as o, StaticWebsiteDefinitionBrand as p, HttpAdapterConfigInput as r, ResolverExternalConfig as s, ConcurrencyPolicy as t, WorkflowServiceConfig as u, IdPExternalConfig as v, AIGatewayConfig as w, IdPGqlOperations as x, IdpDefinitionBrand as y, AllowedValuesOutput as z };
-//# sourceMappingURL=workflow.generated-Br9bmLdX.d.mts.map
+//# sourceMappingURL=workflow.generated-DJULCuRr.d.mts.map

package/docs/cli/application.md

@@ -110,10 +110,45 @@ Before applying changes, `deploy` shows a preview of the planned resource change
 After the detailed list, a summary line is printed:
 
 ```text
-Plan: 5 to create, 3 to update, 1 to delete, 25 unchanged
+Plan: 5 to create, 3 to update, 1 to delete
 ```
 
-Use `--dry-run` to preview the plan without applying anything.
+Use `--dry-run` to preview the plan without applying anything. In dry-run mode the plan is written to **stdout**, so it can be captured in CI without `2>&1`:
+
+```bash
+tailor-sdk deploy --dry-run > plan.txt
+```
+
+In apply mode, the plan is printed to stderr so it does not interfere with piped output.
+
+**JSON Output:**
+
+Pass the global `--json` / `-j` flag to get machine-readable output.
+
+**Dry-run** (`--dry-run --json`): writes a JSON object to stdout:
+
+```json
+{
+  "summary": { "create": 2, "update": 1, "delete": 0, "replace": 0 },
+  "changes": [{ "action": "create", "name": "Order", "labels": ["type"], "namespace": "tailordb" }],
+  "warnings": [
+    { "type": "unmanaged", "resourceType": "tailorDB", "name": "LegacyType" },
+    { "type": "skippedSecret", "resourceType": "secret", "name": "DB_PASSWORD" }
+  ],
+  "conflicts": [{ "resourceType": "tailorDB", "name": "User", "currentOwner": "other-app" }]
+}
+```
+
+- `summary` — counts of each change type.
+- `changes` — planned resource changes, each with `action`, `name`, and optional `labels` / `namespace`.
+- `warnings` — resources not in config (`type: "unmanaged"`) or secrets with missing values (`type: "skippedSecret"`). Unmanaged resources require confirmation in apply mode (apply is cancelled if declined); skipped secrets are non-blocking.
+- `conflicts` — resources owned by another application that conflict with the current config. Require confirmation in apply mode; apply is cancelled if declined.
+
+**Apply** (`--json`): writes a JSON object to stdout:
+
+```json
+{ "summary": { "create": 1, "update": 2, "delete": 0, "replace": 0 }, "status": "applied" }
+```
 
 ## remove
 

package/docs/cli/setup.md

@@ -23,6 +23,7 @@ tailor-sdk setup [options] [command]
 | `--tag-pattern <TAG_PATTERN>`       | -     | Tag glob to match (requires --tag; defaults to v\*)                                                                                               | No       | -          |
 | `--environment <ENVIRONMENT>`       | -     | GitHub Environment for the plan/deploy jobs (defaults to the workspace name)                                                                      | No       | -          |
 | `--no-plan`                         | -     | Disable the plan job for a branch target (cannot be combined with --tag)                                                                          | No       | `false`    |
+| `--erd-preview`                     | -     | Add PR ERD viewer artifacts with current/diff previews for TailorDB namespaces                                                                    | No       | `false`    |
 | `--dir <DIR>`                       | `-d`  | App directory (for monorepo setups)                                                                                                               | No       | `"."`      |
 | `--force`                           | -     | Discard hand edits / take over unmanaged files and regenerate                                                                                     | No       | `false`    |
 

package/docs/cli/tailordb.md

@@ -247,6 +247,7 @@ See [Global Options](../cli-reference.md#global-options) for options available t
 | Command                                       | Description                                                       |
 | --------------------------------------------- | ----------------------------------------------------------------- |
 | [`tailordb erd export`](#tailordb-erd-export) | Export TailorDB ERD static viewer from local TailorDB schema.     |
+| [`tailordb erd diff`](#tailordb-erd-diff)     | Render TailorDB ERD schema diff HTML from exported ERD viewers.   |
 | [`tailordb erd serve`](#tailordb-erd-serve)   | Generate and serve TailorDB ERD locally with watch reload. (beta) |
 | [`tailordb erd deploy`](#tailordb-erd-deploy) | Deploy ERD static website for TailorDB namespace(s).              |
 
@@ -270,6 +271,28 @@ tailor-sdk tailordb erd export [options]
 
 See [Global Options](../cli-reference.md#global-options) for options available to all commands.
 
+#### tailordb erd diff
+
+Render TailorDB ERD schema diff HTML from exported ERD viewers.
+
+**Usage**
+
+```
+tailor-sdk tailordb erd diff [options]
+```
+
+**Options**
+
+| Option                        | Alias | Description                                                             | Required | Default |
+| ----------------------------- | ----- | ----------------------------------------------------------------------- | -------- | ------- |
+| `--base-html <BASE_HTML>`     | -     | Base ERD viewer HTML file                                               | No       | -       |
+| `--head-html <HEAD_HTML>`     | -     | Head ERD viewer HTML file                                               | No       | -       |
+| `--namespace <NAMESPACE>`     | `-n`  | TailorDB namespace name (defaults to the provided ERD schema namespace) | No       | -       |
+| `--output <OUTPUT>`           | `-o`  | Output ERD diff HTML file                                               | Yes      | -       |
+| `--output-json <OUTPUT_JSON>` | -     | Optional output JSON file for the computed diff                         | No       | -       |
+
+See [Global Options](../cli-reference.md#global-options) for options available to all commands.
+
 #### tailordb erd serve
 
 Generate and serve TailorDB ERD locally with watch reload. (beta)
@@ -316,6 +339,7 @@ See [Global Options](../cli-reference.md#global-options) for options available t
 
 - ERD commands build from the local TailorDB schema, including plugin-generated TailorDB types.
 - `tailordb erd export` writes a self-contained `index.html` viewer to `<output>/<namespace>/dist`.
+- `tailordb erd diff` compares exported self-contained viewer HTML files and writes a visual ERD viewer that can switch between the current schema and the highlighted diff.
 - `tailordb erd serve` watches the config file and TailorDB type files, then reloads the browser viewer when the rebuilt `index.html` reports a new embedded schema revision.
 - `tailordb erd deploy` still requires `erdSite` in `tailor.config.ts` because it uploads the generated viewer to a configured Static Website.
 

package/docs/cli/user.md

@@ -14,6 +14,10 @@ tailor-sdk login [options]
 
 **Options**
 
+| Option                | Alias | Description                                                         | Required | Default | Env                       |
+| --------------------- | ----- | ------------------------------------------------------------------- | -------- | ------- | ------------------------- |
+| `--profile <PROFILE>` | `-p`  | Workspace profile whose platform settings should be used for login. | No       | -       | `TAILOR_PLATFORM_PROFILE` |
+
 > One of the following option groups is required:
 
 **User Login:**
@@ -37,9 +41,15 @@ Logout from Tailor Platform.
 **Usage**
 
 ```
-tailor-sdk logout
+tailor-sdk logout [options]
 ```
 
+**Options**
+
+| Option                | Alias | Description                                                          | Required | Default | Env                       |
+| --------------------- | ----- | -------------------------------------------------------------------- | -------- | ------- | ------------------------- |
+| `--profile <PROFILE>` | `-p`  | Workspace profile whose platform settings should be used for logout. | No       | -       | `TAILOR_PLATFORM_PROFILE` |
+
 See [Global Options](../cli-reference.md#global-options) for options available to all commands.
 
 ## user