@tailor-platform/sdk 1.56.0 → 1.57.0

package/dist/{types-BinLwXM9.mjs → types-BwGth3a1.mjs}

@@ -15,15 +15,24 @@ const regex = {
 * @param options - Field options
 * @param fields - Nested fields for object-like types
 * @param values - Allowed values for enum-like fields
+* @param metadata - Pre-built metadata to clone from (used by `clone()`); when
+*   given, the mutable containers are deep-copied here and `options`/`values` are
+*   ignored for metadata construction
 * @returns A new TailorField
 */
-function createTailorField(type, options, fields, values) {
-	const _metadata = { required: true };
-	if (options) {
-		if (options.optional === true) _metadata.required = false;
-		if (options.array === true) _metadata.array = true;
+function createTailorField(type, options, fields, values, metadata) {
+	const _metadata = metadata ? {
+		...metadata,
+		...metadata.allowedValues && { allowedValues: metadata.allowedValues.map((v) => ({ ...v })) },
+		...metadata.validate && { validate: metadata.validate.map((v) => Array.isArray(v) ? [...v] : v) }
+	} : { required: true };
+	if (!metadata) {
+		if (options) {
+			if (options.optional === true) _metadata.required = false;
+			if (options.array === true) _metadata.array = true;
+		}
+		if (values) _metadata.allowedValues = mapAllowedValues(values);
 	}
-	if (values) _metadata.allowedValues = mapAllowedValues(values);
 	/**
 	* Validate a single value (not an array element)
 	* Used internally for array element validation
@@ -33,59 +42,60 @@ function createTailorField(type, options, fields, values) {
 	function validateValue(args) {
 		const { value, data, user, pathArray } = args;
 		const issues = [];
+		const path = pathArray.length > 0 ? pathArray : void 0;
 		switch (type) {
 			case "string":
 				if (typeof value !== "string") issues.push({
 					message: `Expected a string: received ${String(value)}`,
-					path: pathArray.length > 0 ? pathArray : void 0
+					path
 				});
 				break;
 			case "integer":
 				if (typeof value !== "number" || !Number.isInteger(value)) issues.push({
 					message: `Expected an integer: received ${String(value)}`,
-					path: pathArray.length > 0 ? pathArray : void 0
+					path
 				});
 				break;
 			case "float":
 				if (typeof value !== "number" || !Number.isFinite(value)) issues.push({
 					message: `Expected a number: received ${String(value)}`,
-					path: pathArray.length > 0 ? pathArray : void 0
+					path
 				});
 				break;
 			case "boolean":
 				if (typeof value !== "boolean") issues.push({
 					message: `Expected a boolean: received ${String(value)}`,
-					path: pathArray.length > 0 ? pathArray : void 0
+					path
 				});
 				break;
 			case "uuid":
 				if (typeof value !== "string" || !regex.uuid.test(value)) issues.push({
 					message: `Expected a valid UUID: received ${String(value)}`,
-					path: pathArray.length > 0 ? pathArray : void 0
+					path
 				});
 				break;
 			case "date":
 				if (typeof value !== "string" || !regex.date.test(value)) issues.push({
 					message: `Expected to match "yyyy-MM-dd" format: received ${String(value)}`,
-					path: pathArray.length > 0 ? pathArray : void 0
+					path
 				});
 				break;
 			case "datetime":
 				if (typeof value !== "string" || !regex.datetime.test(value)) issues.push({
 					message: `Expected to match ISO format: received ${String(value)}`,
-					path: pathArray.length > 0 ? pathArray : void 0
+					path
 				});
 				break;
 			case "time":
 				if (typeof value !== "string" || !regex.time.test(value)) issues.push({
 					message: `Expected to match "HH:mm" format: received ${String(value)}`,
-					path: pathArray.length > 0 ? pathArray : void 0
+					path
 				});
 				break;
 			case "decimal":
 				if (typeof value !== "string" || !regex.decimal.test(value)) issues.push({
 					message: `Expected a decimal string: received ${String(value)}`,
-					path: pathArray.length > 0 ? pathArray : void 0
+					path
 				});
 				break;
 			case "enum":
@@ -93,14 +103,14 @@ function createTailorField(type, options, fields, values) {
 					const allowedValues = field._metadata.allowedValues.map((v) => v.value);
 					if (typeof value !== "string" || !allowedValues.includes(value)) issues.push({
 						message: `Must be one of [${allowedValues.join(", ")}]: received ${String(value)}`,
-						path: pathArray.length > 0 ? pathArray : void 0
+						path
 					});
 				}
 				break;
 			case "nested":
 				if (typeof value !== "object" || value === null || Array.isArray(value) || value instanceof Date) issues.push({
 					message: `Expected an object: received ${String(value)}`,
-					path: pathArray.length > 0 ? pathArray : void 0
+					path
 				});
 				else if (field.fields && Object.keys(field.fields).length > 0) for (const [fieldName, nestedField] of Object.entries(field.fields)) {
 					const fieldValue = value?.[fieldName];
@@ -129,7 +139,7 @@ function createTailorField(type, options, fields, values) {
 				user
 			})) issues.push({
 				message,
-				path: pathArray.length > 0 ? pathArray : void 0
+				path
 			});
 		}
 		return issues;
@@ -142,11 +152,12 @@ function createTailorField(type, options, fields, values) {
 	function parseInternal(args) {
 		const { value, data, user, pathArray } = args;
 		const issues = [];
+		const path = pathArray.length > 0 ? pathArray : void 0;
 		const isNullOrUndefined = value === null || value === void 0;
 		if (field._metadata.required && isNullOrUndefined) {
 			issues.push({
 				message: "Required field is missing",
-				path: pathArray.length > 0 ? pathArray : void 0
+				path
 			});
 			return { issues };
 		}
@@ -155,7 +166,7 @@ function createTailorField(type, options, fields, values) {
 			if (!Array.isArray(value)) {
 				issues.push({
 					message: "Expected an array",
-					path: pathArray.length > 0 ? pathArray : void 0
+					path
 				});
 				return { issues };
 			}
@@ -182,6 +193,18 @@ function createTailorField(type, options, fields, values) {
 		if (issues.length > 0) return { issues };
 		return { value };
 	}
+	/**
+	* Clone the field and apply metadata updates to the clone.
+	* The original instance is never mutated, so a field shared across places
+	* cannot leak metadata between them.
+	* @param metadataUpdates - Metadata properties to overwrite on the clone
+	* @returns A new field with the updated metadata
+	*/
+	function cloneWith(metadataUpdates) {
+		const cloned = field.clone();
+		Object.assign(cloned._metadata, metadataUpdates);
+		return cloned;
+	}
 	const field = {
 		type,
 		fields: fields ?? {},
@@ -192,16 +215,13 @@ function createTailorField(type, options, fields, values) {
 			return { ...this._metadata };
 		},
 		description(description) {
-			this._metadata.description = description;
-			return this;
+			return cloneWith({ description });
 		},
 		typeName(typeName) {
-			this._metadata.typeName = typeName;
-			return this;
+			return cloneWith({ typeName });
 		},
 		validate(...validateInputs) {
-			this._metadata.validate = validateInputs;
-			return this;
+			return cloneWith({ validate: validateInputs });
 		},
 		parse(args) {
 			return parseInternal({
@@ -211,7 +231,16 @@ function createTailorField(type, options, fields, values) {
 				pathArray: []
 			});
 		},
-		_parseInternal: parseInternal
+		_parseInternal: parseInternal,
+		clone() {
+			let clonedFields = fields;
+			if (fields) {
+				const cloned = {};
+				for (const [key, nestedField] of Object.entries(fields)) cloned[key] = nestedField.clone();
+				clonedFields = cloned;
+			}
+			return createTailorField(type, options, clonedFields, values, this._metadata);
+		}
 	};
 	return field;
 }
@@ -340,4 +369,4 @@ const t = {
 
 //#endregion
 export { t };
-//# sourceMappingURL=types-BinLwXM9.mjs.map
+//# sourceMappingURL=types-BwGth3a1.mjs.map

package/dist/types-BwGth3a1.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-BwGth3a1.mjs","names":[],"sources":["../src/configure/types/type.ts"],"sourcesContent":["import { type AllowedValues, type AllowedValuesOutput, mapAllowedValues } from \"./field\";\nimport type {\n  DefinedFieldMetadata,\n  TailorFieldType,\n  TailorToTs,\n  FieldMetadata,\n  FieldOptions,\n  FieldOutput,\n} from \"@/types/field-types\";\nimport type { InferFieldsOutput, Prettify } from \"@/types/helpers\";\nimport type { TailorField as TailorFieldBase } from \"@/types/tailor-field\";\nimport type { TailorUser } from \"@/types/user\";\nimport type { FieldValidateInput } from \"@/types/validation\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\n// This helper type intentionally uses `any` as a placeholder for unknown field output.\n// oxlint-disable-next-line no-explicit-any\nexport type TailorAnyField = TailorField<any>;\n\n/**\n * Full TailorField interface with builder methods.\n * Extends the minimal structural interface from types/ with fluent API methods.\n */\nexport interface TailorField<\n  Defined extends DefinedFieldMetadata = DefinedFieldMetadata,\n  // Generic default output type (kept loose on purpose for library ergonomics).\n  // oxlint-disable-next-line no-explicit-any\n  Output = any,\n  M extends FieldMetadata = FieldMetadata,\n  T extends TailorFieldType = TailorFieldType,\n> extends TailorFieldBase<Defined, Output, M, T> {\n  readonly fields: Record<string, TailorAnyField>;\n  _metadata: M;\n\n  /**\n   * Set a description for the field\n   * @param description - The description text\n   * @returns The field with updated metadata\n   */\n  description<CurrentDefined extends Defined>(\n    this: CurrentDefined extends { description: unknown }\n      ? never\n      : TailorField<CurrentDefined, Output>,\n    description: string,\n  ): TailorField<Prettify<CurrentDefined & { description: true }>, Output>;\n\n  /**\n   * Set a custom type name for enum or nested types\n   * @param typeName - The custom type name\n   * @returns The field with updated metadata\n   */\n  typeName<CurrentDefined extends Defined>(\n    this: CurrentDefined extends { typeName: unknown }\n      ? never\n      : CurrentDefined extends { type: \"enum\" | \"nested\" }\n        ? TailorField<CurrentDefined, Output>\n        : never,\n    typeName: string,\n  ): TailorField<Prettify<CurrentDefined & { typeName: true }>, Output>;\n\n  /**\n   * Add validation functions to the field\n   * @param validate - One or more validation functions\n   * @returns The field with updated metadata\n   */\n  validate<CurrentDefined extends Defined>(\n    this: CurrentDefined extends { validate: unknown }\n      ? never\n      : TailorField<CurrentDefined, Output>,\n    ...validate: FieldValidateInput<Output>[]\n  ): TailorField<Prettify<CurrentDefined & { validate: true }>, Output>;\n\n  /**\n   * Parse and validate a value against this field's validation rules\n   * Returns StandardSchema Result type with success or failure\n   * @param args - Value, context data, and user\n   * @returns Validation result\n   */\n  parse(args: FieldParseArgs): StandardSchemaV1.Result<Output>;\n\n  /**\n   * Internal parse method that tracks field path for nested validation\n   * @private\n   * @param args - Parse arguments\n   * @returns Validation result\n   */\n  _parseInternal(args: FieldParseInternalArgs): StandardSchemaV1.Result<Output>;\n}\n\n/**\n * Internal shape carried by every runtime field for clone-on-write support.\n *\n * `clone()` is intentionally kept off the public {@link TailorField} interface:\n * adding it there would force `TailorDBField` (which has a differently-typed\n * `clone`) to stop being assignable to `TailorField`, breaking the supported\n * `t.object({ field: db.string() })` usage. Every `t.*` and `db.*` field carries\n * a `clone()` at runtime, so the internal cast in `clone()` is safe.\n */\ntype CloneableField = { clone(): TailorAnyField };\n\nconst regex = {\n  uuid: /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,\n  date: /^(?<year>\\d{4})-(?<month>\\d{2})-(?<day>\\d{2})$/,\n  time: /^(?<hour>\\d{2}):(?<minute>\\d{2})$/,\n  datetime:\n    /^(?<year>\\d{4})-(?<month>\\d{2})-(?<day>\\d{2})T(?<hour>\\d{2}):(?<minute>\\d{2}):(?<second>\\d{2})(.(?<millisec>\\d{3}))?Z$/,\n  decimal: /^-?(\\d+\\.?\\d*|\\.\\d+)([eE][+-]?\\d+)?$/,\n} as const;\n\ntype FieldParseArgs = {\n  value: unknown;\n  data: unknown;\n  user: TailorUser;\n};\n\ntype FieldValidateValueArgs<T extends TailorFieldType> = {\n  value: TailorToTs[T];\n  data: unknown;\n  user: TailorUser;\n  pathArray: string[];\n};\n\ntype FieldParseInternalArgs = {\n  // Runtime input is unknown/untyped; we validate and narrow it inside the parser.\n  // oxlint-disable-next-line no-explicit-any\n  value: any;\n  data: unknown;\n  user: TailorUser;\n  pathArray: string[];\n};\n\n/**\n * Creates a new TailorField instance.\n * @param type - Field type\n * @param options - Field options\n * @param fields - Nested fields for object-like types\n * @param values - Allowed values for enum-like fields\n * @param metadata - Pre-built metadata to clone from (used by `clone()`); when\n *   given, the mutable containers are deep-copied here and `options`/`values` are\n *   ignored for metadata construction\n * @returns A new TailorField\n */\nfunction createTailorField<\n  const T extends TailorFieldType,\n  const TOptions extends FieldOptions,\n  const OutputBase = TailorToTs[T],\n>(\n  type: T,\n  options?: TOptions,\n  fields?: Record<string, TailorAnyField>,\n  values?: AllowedValues,\n  metadata?: FieldMetadata,\n): TailorField<\n  { type: T; array: TOptions extends { array: true } ? true : false },\n  FieldOutput<OutputBase, TOptions>\n> {\n  // When cloning, take ownership of the source metadata and deep-copy its mutable\n  // containers (enum value objects and `[fn, message]` validator tuples; validator\n  // functions are kept by reference) so no two instances share mutable state.\n  const _metadata: FieldMetadata = metadata\n    ? {\n        ...metadata,\n        ...(metadata.allowedValues && {\n          allowedValues: metadata.allowedValues.map((v) => ({ ...v })),\n        }),\n        ...(metadata.validate && {\n          validate: metadata.validate.map((v) => (Array.isArray(v) ? ([...v] as typeof v) : v)),\n        }),\n      }\n    : { required: true };\n\n  if (!metadata) {\n    if (options) {\n      if (options.optional === true) {\n        _metadata.required = false;\n      }\n      if (options.array === true) {\n        _metadata.array = true;\n      }\n    }\n    if (values) {\n      _metadata.allowedValues = mapAllowedValues(values);\n    }\n  }\n\n  /**\n   * Validate a single value (not an array element)\n   * Used internally for array element validation\n   * @param args - Value, context data, and user\n   * @returns Array of validation issues\n   */\n  function validateValue(args: FieldValidateValueArgs<T>): StandardSchemaV1.Issue[] {\n    const { value, data, user, pathArray } = args;\n    const issues: StandardSchemaV1.Issue[] = [];\n    const path = pathArray.length > 0 ? pathArray : undefined;\n\n    // Type-specific validation\n    switch (type) {\n      case \"string\":\n        if (typeof value !== \"string\") {\n          issues.push({\n            message: `Expected a string: received ${String(value)}`,\n            path,\n          });\n        }\n        break;\n\n      case \"integer\":\n        if (typeof value !== \"number\" || !Number.isInteger(value)) {\n          issues.push({\n            message: `Expected an integer: received ${String(value)}`,\n            path,\n          });\n        }\n        break;\n\n      case \"float\":\n        if (typeof value !== \"number\" || !Number.isFinite(value)) {\n          issues.push({\n            message: `Expected a number: received ${String(value)}`,\n            path,\n          });\n        }\n        break;\n\n      case \"boolean\":\n        if (typeof value !== \"boolean\") {\n          issues.push({\n            message: `Expected a boolean: received ${String(value)}`,\n            path,\n          });\n        }\n        break;\n\n      case \"uuid\":\n        if (typeof value !== \"string\" || !regex.uuid.test(value)) {\n          issues.push({\n            message: `Expected a valid UUID: received ${String(value)}`,\n            path,\n          });\n        }\n        break;\n      case \"date\":\n        if (typeof value !== \"string\" || !regex.date.test(value)) {\n          issues.push({\n            message: `Expected to match \"yyyy-MM-dd\" format: received ${String(value)}`,\n            path,\n          });\n        }\n        break;\n      case \"datetime\":\n        if (typeof value !== \"string\" || !regex.datetime.test(value)) {\n          issues.push({\n            message: `Expected to match ISO format: received ${String(value)}`,\n            path,\n          });\n        }\n        break;\n      case \"time\":\n        if (typeof value !== \"string\" || !regex.time.test(value)) {\n          issues.push({\n            message: `Expected to match \"HH:mm\" format: received ${String(value)}`,\n            path,\n          });\n        }\n        break;\n      case \"decimal\":\n        if (typeof value !== \"string\" || !regex.decimal.test(value)) {\n          issues.push({\n            message: `Expected a decimal string: received ${String(value)}`,\n            path,\n          });\n        }\n        break;\n\n      case \"enum\":\n        if (field._metadata.allowedValues) {\n          const allowedValues = field._metadata.allowedValues.map((v) => v.value);\n          if (typeof value !== \"string\" || !allowedValues.includes(value)) {\n            issues.push({\n              message: `Must be one of [${allowedValues.join(\", \")}]: received ${String(value)}`,\n              path,\n            });\n          }\n        }\n        break;\n\n      case \"nested\":\n        // Validate nested object fields\n        if (\n          typeof value !== \"object\" ||\n          value === null ||\n          Array.isArray(value) ||\n          value instanceof Date\n        ) {\n          issues.push({\n            message: `Expected an object: received ${String(value)}`,\n            path,\n          });\n        } else if (field.fields && Object.keys(field.fields).length > 0) {\n          for (const [fieldName, nestedField] of Object.entries(field.fields)) {\n            const fieldValue = value?.[fieldName];\n            const result = nestedField._parseInternal({\n              value: fieldValue,\n              data,\n              user,\n              pathArray: pathArray.concat(fieldName),\n            });\n            if (result.issues) {\n              issues.push(...result.issues);\n            }\n          }\n        }\n        break;\n    }\n\n    // Custom validation functions\n    const validateFns = field._metadata.validate;\n    if (validateFns && validateFns.length > 0) {\n      for (const validateInput of validateFns) {\n        const { fn, message } =\n          typeof validateInput === \"function\"\n            ? { fn: validateInput, message: \"Validation failed\" }\n            : { fn: validateInput[0], message: validateInput[1] };\n\n        if (!fn({ value, data, user })) {\n          issues.push({\n            message,\n            path,\n          });\n        }\n      }\n    }\n\n    return issues;\n  }\n\n  /**\n   * Internal parse method that tracks field path for nested validation\n   * @param args - Parse arguments\n   * @returns Parse result with value or issues\n   */\n  function parseInternal(\n    args: FieldParseInternalArgs,\n  ): StandardSchemaV1.Result<FieldOutput<OutputBase, TOptions>> {\n    const { value, data, user, pathArray } = args;\n    const issues: StandardSchemaV1.Issue[] = [];\n    const path = pathArray.length > 0 ? pathArray : undefined;\n\n    // 1. Check required/optional\n    const isNullOrUndefined = value === null || value === undefined;\n    if (field._metadata.required && isNullOrUndefined) {\n      issues.push({\n        message: \"Required field is missing\",\n        path,\n      });\n      return { issues };\n    }\n\n    // If optional and null/undefined, skip further validation and normalize to null\n    if (!field._metadata.required && isNullOrUndefined) {\n      return { value: value ?? null };\n    }\n\n    // 2. Check array type\n    if (field._metadata.array) {\n      if (!Array.isArray(value)) {\n        issues.push({\n          message: \"Expected an array\",\n          path,\n        });\n        return { issues };\n      }\n\n      // Validate each array element (without array flag)\n      for (let i = 0; i < value.length; i++) {\n        const elementValue = value[i];\n        const elementPath = pathArray.concat(`[${i}]`);\n\n        // Validate element with same type but without array flag\n        const elementIssues = validateValue({\n          value: elementValue,\n          data,\n          user,\n          pathArray: elementPath,\n        });\n        if (elementIssues.length > 0) {\n          issues.push(...elementIssues);\n        }\n      }\n\n      if (issues.length > 0) {\n        return { issues };\n      }\n      return { value: value as FieldOutput<OutputBase, TOptions> };\n    }\n\n    // 3. Type-specific validation and custom validation\n    const valueIssues = validateValue({ value, data, user, pathArray });\n    issues.push(...valueIssues);\n\n    if (issues.length > 0) {\n      return { issues };\n    }\n\n    return { value };\n  }\n\n  /**\n   * Clone the field and apply metadata updates to the clone.\n   * The original instance is never mutated, so a field shared across places\n   * cannot leak metadata between them.\n   * @param metadataUpdates - Metadata properties to overwrite on the clone\n   * @returns A new field with the updated metadata\n   */\n  function cloneWith(metadataUpdates: Partial<FieldMetadata>) {\n    const cloned = field.clone();\n    Object.assign(cloned._metadata, metadataUpdates);\n    return cloned;\n  }\n\n  const field: TailorField<\n    { type: T; array: TOptions extends { array: true } ? true : false },\n    FieldOutput<OutputBase, TOptions>\n  > &\n    CloneableField = {\n    type,\n    fields: fields ?? {},\n    _defined: undefined as unknown as {\n      type: T;\n      array: TOptions extends { array: true } ? true : false;\n    },\n    _output: undefined as FieldOutput<OutputBase, TOptions>,\n    _metadata,\n\n    get metadata() {\n      return { ...this._metadata };\n    },\n\n    description(description: string) {\n      // Clone-on-write so a shared field instance never leaks metadata.\n      // oxlint-disable-next-line no-explicit-any\n      return cloneWith({ description }) as any;\n    },\n\n    typeName(typeName: string) {\n      // Clone-on-write so a shared field instance never leaks metadata.\n      // oxlint-disable-next-line no-explicit-any\n      return cloneWith({ typeName }) as any;\n    },\n\n    validate(...validateInputs: FieldValidateInput<FieldOutput<OutputBase, TOptions>>[]) {\n      // Clone-on-write so a shared field instance never leaks metadata.\n      // oxlint-disable-next-line no-explicit-any\n      return cloneWith({ validate: validateInputs }) as any;\n    },\n\n    parse(args: FieldParseArgs): StandardSchemaV1.Result<FieldOutput<OutputBase, TOptions>> {\n      return parseInternal({\n        value: args.value,\n        data: args.data,\n        user: args.user,\n        pathArray: [],\n      });\n    },\n\n    _parseInternal: parseInternal,\n\n    clone() {\n      // Deep clone nested object fields so the new instance shares no mutable state.\n      let clonedFields = fields;\n      if (fields) {\n        const cloned: Record<string, TailorAnyField> = {};\n        for (const [key, nestedField] of Object.entries(fields)) {\n          // Both t.* and db.* fields carry clone() at runtime (see CloneableField).\n          cloned[key] = (nestedField as TailorAnyField & CloneableField).clone();\n        }\n        clonedFields = cloned;\n      }\n\n      // Rebuild via the factory, handing it this field's metadata so the new\n      // parseInternal/validateValue closures rebind to the clone and the factory\n      // owns the metadata deep-copy.\n      // oxlint-disable-next-line no-explicit-any\n      return createTailorField(type, options, clonedFields, values, this._metadata) as any;\n    },\n  };\n\n  return field;\n}\n\n/**\n * Create a UUID field for resolver input/output.\n * @param options - Field configuration options\n * @returns A UUID field\n * @example t.uuid()\n */\nfunction uuid<const Opt extends FieldOptions>(options?: Opt) {\n  return createTailorField(\"uuid\", options);\n}\n\n/**\n * Create a string field for resolver input/output.\n * @param options - Field configuration options\n * @returns A string field\n * @example t.string()\n * @example t.string({ optional: true })\n * @example t.string({ array: true })\n */\nfunction string<const Opt extends FieldOptions>(options?: Opt) {\n  return createTailorField(\"string\", options);\n}\n\n/**\n * Create a boolean field for resolver input/output.\n * @param options - Field configuration options\n * @returns A boolean field\n * @example t.bool()\n */\nfunction bool<const Opt extends FieldOptions>(options?: Opt) {\n  return createTailorField(\"boolean\", options);\n}\n\n/**\n * Create an integer field for resolver input/output.\n * @param options - Field configuration options\n * @returns An integer field\n * @example t.int()\n */\nfunction int<const Opt extends FieldOptions>(options?: Opt) {\n  return createTailorField(\"integer\", options);\n}\n\n/**\n * Create a float field for resolver input/output.\n * @param options - Field configuration options\n * @returns A float field\n * @example t.float()\n */\nfunction float<const Opt extends FieldOptions>(options?: Opt) {\n  return createTailorField(\"float\", options);\n}\n\n/**\n * Create a decimal field for resolver input/output (stored as string for precision).\n * @param options - Field configuration options\n * @returns A decimal field\n * @example t.decimal()\n * @example t.decimal({ optional: true })\n */\nfunction decimal<const Opt extends FieldOptions>(options?: Opt) {\n  return createTailorField(\"decimal\", options);\n}\n\n/**\n * Create a date field for resolver input/output.\n * @param options - Field configuration options\n * @returns A date field\n * @example t.date()\n */\nfunction date<const Opt extends FieldOptions>(options?: Opt) {\n  return createTailorField(\"date\", options);\n}\n\n/**\n * Create a datetime field for resolver input/output.\n * @param options - Field configuration options\n * @returns A datetime field\n * @example t.datetime()\n */\nfunction datetime<const Opt extends FieldOptions>(options?: Opt) {\n  return createTailorField(\"datetime\", options);\n}\n\n/**\n * Create a time field for resolver input/output.\n * @param options - Field configuration options\n * @returns A time field\n * @example t.time()\n */\nfunction time<const Opt extends FieldOptions>(options?: Opt) {\n  return createTailorField(\"time\", options);\n}\n\n/**\n * Create an enum field for resolver input/output.\n * @param values - Array of allowed string values\n * @param options - Field configuration options\n * @returns An enum field\n * @example t.enum([\"active\", \"inactive\"])\n */\nfunction _enum<const V extends AllowedValues, const Opt extends FieldOptions>(\n  values: V,\n  options?: Opt,\n): TailorField<\n  { type: \"enum\"; array: Opt extends { array: true } ? true : false },\n  FieldOutput<AllowedValuesOutput<V>, Opt>\n> {\n  return createTailorField<\"enum\", Opt, AllowedValuesOutput<V>>(\"enum\", options, undefined, values);\n}\n\n/**\n * Create a nested object field for resolver input/output.\n * @param fields - Record of field definitions\n * @param options - Field options (optional, array)\n * @returns A nested object field\n * @example\n * // Single object:\n * output: t.object({ name: t.string(), email: t.string() })\n * @example\n * // Array of objects:\n * items: t.object({ name: t.string() }, { array: true })\n */\nfunction object<const F extends Record<string, TailorAnyField>, const Opt extends FieldOptions>(\n  fields: F,\n  options?: Opt,\n) {\n  const objectField = createTailorField(\"nested\", options, fields) as TailorField<\n    { type: \"nested\"; array: Opt extends { array: true } ? true : false },\n    FieldOutput<InferFieldsOutput<F>, Opt>\n  >;\n  return objectField;\n}\n\nexport const t = {\n  uuid,\n  string,\n  bool,\n  int,\n  float,\n  decimal,\n  date,\n  datetime,\n  time,\n  enum: _enum,\n  object,\n};\n"],"mappings":"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"}

package/dist/{types-UeXbHFXW.mjs → types-Ccwchyj5.mjs}

@@ -1,5 +1,5 @@
 
 import { t as mapAllowedValues } from "./field-C4zdJLW5.mjs";
-import { t } from "./types-BinLwXM9.mjs";
+import { t } from "./types-BwGth3a1.mjs";
 
 export { t };

package/dist/utils/test/index.d.mts

@@ -1,6 +1,6 @@
 import { M as TailorInvoker } from "../../tailordb-BlBGmQK-.mjs";
-import { W as TailorDBType } from "../../workflow.generated-BHdBzgx6.mjs";
-import { At as TailorField, bt as WORKFLOW_TEST_ENV_KEY, n as output } from "../../index-BW3v5XYC.mjs";
+import { W as TailorDBType } from "../../workflow.generated-Kz-nQrTf.mjs";
+import { At as TailorField, bt as WORKFLOW_TEST_ENV_KEY, n as output } from "../../index-B61gFI9a.mjs";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/utils/test/mock.d.ts

package/dist/{workflow.generated-BHdBzgx6.d.mts → workflow.generated-Kz-nQrTf.d.mts}

@@ -36,12 +36,21 @@ type TailorTypePermission<User extends object = InferredAttributeMap, Type exten
 type ActionPermission<Level extends "record" | "gql" = "record" | "gql", User extends object = InferredAttributeMap, Type extends object = object, Update extends boolean = boolean> = {
   conditions: PermissionCondition<Level, User, Update, Type> | readonly PermissionCondition<Level, User, Update, Type>[];
   description?: string | undefined;
+  /**
+   * Whether matching records are granted (`true`) or denied (`false`).
+   * Omitting `permit` in this object form defaults to `deny` and emits a
+   * warning; set it explicitly. (The array shorthand defaults to `allow`.)
+   */
   permit?: boolean;
 } | readonly [...PermissionCondition<Level, User, Update, Type>, ...([] | [boolean])] | readonly [...PermissionCondition<Level, User, Update, Type>[], ...([] | [boolean])];
 type TailorTypeGqlPermission<User extends object = InferredAttributeMap, Type extends object = object> = readonly GqlPermissionPolicy<User, Type>[];
 type GqlPermissionPolicy<User extends object = InferredAttributeMap, Type extends object = object> = {
   conditions: readonly PermissionCondition<"gql", User, boolean, Type>[];
   actions: "all" | readonly GqlPermissionAction[];
+  /**
+   * Whether matching requests are granted (`true`) or denied (`false`).
+   * Omitting `permit` defaults to `deny` and emits a warning; set it explicitly.
+   */
   permit?: boolean;
   description?: string;
 };
@@ -1403,4 +1412,4 @@ type ConcurrencyPolicy = {
 };
 //#endregion
 export { BeforeLoginHookArgs as A, TailorAnyDBField as B, IdPGqlOperationsInput as C, AuthExternalConfig as D, AuthConnectionTokenResult as E, UserAttributeListKey as F, db as G, TailorDBField as H, UserAttributeMap as I, TailorTypePermission as J, PermissionCondition as K, UsernameFieldKey as L, OAuth2ClientGrantType as M, SCIMAttributeType as N, AuthOwnConfig as O, UserAttributeKey as P, AllowedValuesOutput as Q, AuthConnectionConfig as R, IdPGqlOperations as S, AuthConfig as T, TailorDBInstance as U, TailorAnyDBType as V, TailorDBType as W, unsafeAllowAllTypePermission as X, unsafeAllowAllGqlPermission as Y, AllowedValues as Z, IdPConfig as _, ExecutorServiceConfig as a, IdpDefinitionBrand as b, ResolverServiceConfig as c, WorkflowServiceInput as d, StaticWebsiteConfig as f, SecretsDefinitionBrand as g, SecretsConfig as h, AppConfig as i, DefinedAuth as j, AuthServiceInput as k, ResolverServiceInput as l, StaticWebsiteInput as m, RetryPolicy as n, ExecutorServiceInput as o, StaticWebsiteDefinitionBrand as p, TailorTypeGqlPermission as q, HttpAdapterConfigInput as r, ResolverExternalConfig as s, ConcurrencyPolicy as t, WorkflowServiceConfig as u, IdPExternalConfig as v, IdPInput as w, IdPEmailConfig as x, IdPUserField as y, AuthConnectionOAuth2Config as z };
-//# sourceMappingURL=workflow.generated-BHdBzgx6.d.mts.map
+//# sourceMappingURL=workflow.generated-Kz-nQrTf.d.mts.map

package/docs/cli/tailordb.md

@@ -28,11 +28,11 @@ tailor-sdk tailordb [command]
 
 **Commands**
 
-| Command                                     | Description                                                           |
-| ------------------------------------------- | --------------------------------------------------------------------- |
-| [`tailordb truncate`](#tailordb-truncate)   | Truncate (delete all records from) TailorDB tables.                   |
-| [`tailordb migration`](#tailordb-migration) | Manage TailorDB schema migrations.                                    |
-| [`tailordb erd`](#tailordb-erd)             | Generate ERD artifacts for TailorDB namespaces using Liam ERD. (beta) |
+| Command                                     | Description                                                               |
+| ------------------------------------------- | ------------------------------------------------------------------------- |
+| [`tailordb truncate`](#tailordb-truncate)   | Truncate (delete all records from) TailorDB tables.                       |
+| [`tailordb migration`](#tailordb-migration) | Manage TailorDB schema migrations.                                        |
+| [`tailordb erd`](#tailordb-erd)             | Generate TailorDB ERD viewer artifacts from local TailorDB schema. (beta) |
 
 <!-- politty:command:tailordb:subcommands:end -->
 
@@ -357,7 +357,7 @@ See [Global Options](../cli-reference.md#global-options) for options available t
 
 <!-- politty:command:tailordb erd:description:start -->
 
-Generate ERD artifacts for TailorDB namespaces using Liam ERD. (beta)
+Generate TailorDB ERD viewer artifacts from local TailorDB schema. (beta)
 
 <!-- politty:command:tailordb erd:description:end -->
 
@@ -375,11 +375,11 @@ tailor-sdk tailordb erd [command]
 
 **Commands**
 
-| Command                                       | Description                                                      |
-| --------------------------------------------- | ---------------------------------------------------------------- |
-| [`tailordb erd export`](#tailordb-erd-export) | Export Liam ERD dist from applied TailorDB schema.               |
-| [`tailordb erd serve`](#tailordb-erd-serve)   | Generate and serve ERD locally (liam build + serve dist). (beta) |
-| [`tailordb erd deploy`](#tailordb-erd-deploy) | Deploy ERD static website for TailorDB namespace(s).             |
+| Command                                       | Description                                                       |
+| --------------------------------------------- | ----------------------------------------------------------------- |
+| [`tailordb erd export`](#tailordb-erd-export) | Export TailorDB ERD static viewer from local TailorDB schema.     |
+| [`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).              |
 
 <!-- politty:command:tailordb erd:subcommands:end -->
 
@@ -396,7 +396,7 @@ See [Global Options](../cli-reference.md#global-options) for options available t
 
 <!-- politty:command:tailordb erd export:description:start -->
 
-Export Liam ERD dist from applied TailorDB schema.
+Export TailorDB ERD static viewer from local TailorDB schema.
 
 <!-- politty:command:tailordb erd export:description:end -->
 
@@ -414,13 +414,11 @@ tailor-sdk tailordb erd export [options]
 
 **Options**
 
-| Option                          | Alias | Description                                                                                          | Required | Default              | Env                               |
-| ------------------------------- | ----- | ---------------------------------------------------------------------------------------------------- | -------- | -------------------- | --------------------------------- |
-| `--workspace-id <WORKSPACE_ID>` | `-w`  | Workspace ID                                                                                         | No       | -                    | `TAILOR_PLATFORM_WORKSPACE_ID`    |
-| `--profile <PROFILE>`           | `-p`  | Workspace profile                                                                                    | No       | -                    | `TAILOR_PLATFORM_PROFILE`         |
-| `--config <CONFIG>`             | `-c`  | Path to SDK config file                                                                              | No       | `"tailor.config.ts"` | `TAILOR_PLATFORM_SDK_CONFIG_PATH` |
-| `--namespace <NAMESPACE>`       | `-n`  | TailorDB namespace name (optional if only one namespace is defined in config)                        | No       | -                    | -                                 |
-| `--output <OUTPUT>`             | `-o`  | Output directory path for tbls-compatible ERD JSON (writes to `<outputDir>/<namespace>/schema.json`) | No       | `".tailor-sdk/erd"`  | -                                 |
+| Option                    | Alias | Description                                                                                    | Required | Default              | Env                               |
+| ------------------------- | ----- | ---------------------------------------------------------------------------------------------- | -------- | -------------------- | --------------------------------- |
+| `--config <CONFIG>`       | `-c`  | Path to SDK config file                                                                        | No       | `"tailor.config.ts"` | `TAILOR_PLATFORM_SDK_CONFIG_PATH` |
+| `--namespace <NAMESPACE>` | `-n`  | TailorDB namespace name (optional if only one namespace is defined in config)                  | No       | -                    | -                                 |
+| `--output <OUTPUT>`       | `-o`  | Output directory path for TailorDB ERD viewer files (writes to `<outputDir>/<namespace>/dist`) | No       | `".tailor-sdk/erd"`  | -                                 |
 
 <!-- politty:command:tailordb erd export:options:end -->
 
@@ -437,7 +435,7 @@ See [Global Options](../cli-reference.md#global-options) for options available t
 
 <!-- politty:command:tailordb erd serve:description:start -->
 
-Generate and serve ERD locally (liam build + serve dist). (beta)
+Generate and serve TailorDB ERD locally with watch reload. (beta)
 
 <!-- politty:command:tailordb erd serve:description:end -->
 
@@ -455,12 +453,12 @@ tailor-sdk tailordb erd serve [options]
 
 **Options**
 
-| Option                          | Alias | Description                                                               | Required | Default              | Env                               |
-| ------------------------------- | ----- | ------------------------------------------------------------------------- | -------- | -------------------- | --------------------------------- |
-| `--workspace-id <WORKSPACE_ID>` | `-w`  | Workspace ID                                                              | No       | -                    | `TAILOR_PLATFORM_WORKSPACE_ID`    |
-| `--profile <PROFILE>`           | `-p`  | Workspace profile                                                         | No       | -                    | `TAILOR_PLATFORM_PROFILE`         |
-| `--config <CONFIG>`             | `-c`  | Path to SDK config file                                                   | No       | `"tailor.config.ts"` | `TAILOR_PLATFORM_SDK_CONFIG_PATH` |
-| `--namespace <NAMESPACE>`       | `-n`  | TailorDB namespace name (uses first namespace in config if not specified) | No       | -                    | -                                 |
+| Option                    | Alias | Description                                                               | Required | Default              | Env                               |
+| ------------------------- | ----- | ------------------------------------------------------------------------- | -------- | -------------------- | --------------------------------- |
+| `--config <CONFIG>`       | `-c`  | Path to SDK config file                                                   | No       | `"tailor.config.ts"` | `TAILOR_PLATFORM_SDK_CONFIG_PATH` |
+| `--namespace <NAMESPACE>` | `-n`  | TailorDB namespace name (uses first namespace in config if not specified) | No       | -                    | -                                 |
+| `--port <PORT>`           | -     | Local server port (0 selects a free port)                                 | No       | `0`                  | -                                 |
+| `--open`                  | -     | Open the ERD viewer in the default browser                                | No       | `false`              | -                                 |
 
 <!-- politty:command:tailordb erd serve:options:end -->
 
@@ -510,6 +508,13 @@ See [Global Options](../cli-reference.md#global-options) for options available t
 
 <!-- politty:command:tailordb erd deploy:global-options-link:end -->
 
+**Notes:**
+
+- 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 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.
+
 **Usage Examples:**
 
 ```bash

package/docs/cli-reference.md

@@ -130,8 +130,8 @@ Commands for managing TailorDB tables, data, and schema migrations.
 | [tailordb migration script](./cli/tailordb.md#tailordb-migration-script)     | Add a migration script (migrate.ts) template to an existing migration directory.                                          |
 | [tailordb migration set](./cli/tailordb.md#tailordb-migration-set)           | Set migration checkpoint to a specific number.                                                                            |
 | [tailordb migration status](./cli/tailordb.md#tailordb-migration-status)     | Show the current migration status for TailorDB namespaces, including applied and pending migrations.                      |
-| [tailordb erd export](./cli/tailordb.md#tailordb-erd-export)                 | Export Liam ERD dist from applied TailorDB schema.                                                                        |
-| [tailordb erd serve](./cli/tailordb.md#tailordb-erd-serve)                   | Generate and serve ERD locally (liam build + serve dist). (beta)                                                          |
+| [tailordb erd export](./cli/tailordb.md#tailordb-erd-export)                 | Export TailorDB ERD static viewer from local TailorDB schema.                                                             |
+| [tailordb erd serve](./cli/tailordb.md#tailordb-erd-serve)                   | Generate and serve TailorDB ERD locally with watch reload. (beta)                                                         |
 | [tailordb erd deploy](./cli/tailordb.md#tailordb-erd-deploy)                 | Deploy ERD static website for TailorDB namespace(s).                                                                      |
 
 ### [Query Commands](./cli/query.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tailor-platform/sdk",
-  "version": "1.56.0",
+  "version": "1.57.0",
   "description": "Tailor Platform SDK - The SDK to work with Tailor Platform",
   "license": "MIT",
   "repository": {
@@ -143,7 +143,6 @@
     "@inquirer/core": "11.2.1",
     "@inquirer/prompts": "8.5.2",
     "@jridgewell/trace-mapping": "0.3.31",
-    "@liam-hq/cli": "0.7.24",
     "@napi-rs/keyring": "1.3.0",
     "@opentelemetry/api": "1.9.1",
     "@opentelemetry/exporter-trace-otlp-proto": "0.218.0",
@@ -177,7 +176,6 @@
     "politty": "0.5.1",
     "rolldown": "1.0.3",
     "semver": "7.8.1",
-    "serve": "14.2.6",
     "sql-highlight": "6.1.0",
     "std-env": "4.1.0",
     "table": "6.9.0",

package/dist/application-C9-t0qQb.mjs

@@ -1,4 +0,0 @@
-
-import { n as generatePluginFilesIfNeeded, r as loadApplication, t as defineApplication } from "./application-YHZIkjdy.mjs";
-
-export { defineApplication };