@noormdev/sdk 1.0.0-alpha.20 → 1.0.0-alpha.21

package/dist/index.d.ts

@@ -2255,6 +2255,39 @@ export interface TableDetail {
 	foreignKeys: ForeignKeySummary[];
 	rowCountEstimate?: number;
 }
+/**
+ * Teardown Types
+ *
+ * Types for database reset and teardown operations.
+ * Supports data wipe (truncate) and schema teardown (drop).
+ */
+/**
+ * Options for truncating table data.
+ *
+ * @example
+ * ```typescript
+ * // Truncate all tables except preserved ones from settings
+ * await truncateData(db, 'postgres', {
+ *     preserve: ['AppSettings', 'UserRoles'],
+ *     restartIdentity: true,
+ * })
+ *
+ * // Truncate only specific tables
+ * await truncateData(db, 'postgres', {
+ *     only: ['users', 'posts'],
+ * })
+ * ```
+ */
+export interface TruncateOptions {
+	/** Tables to preserve (won't be truncated) */
+	preserve?: string[];
+	/** If set, only truncate these tables (inverse of preserve) */
+	only?: string[];
+	/** Restart identity/auto-increment sequences (default: true) */
+	restartIdentity?: boolean;
+	/** Dry run - return SQL without executing */
+	dryRun?: boolean;
+}
 /**
  * Result of a truncate operation.
  */
@@ -2357,12 +2390,22 @@ export declare class DbNamespace {
 	/**
 	 * Wipe all data, keeping the schema intact.
 	 *
+	 * User-provided preserve/only options take priority.
+	 * Falls back to settings.teardown.preserveTables from settings.yml.
+	 *
 	 * @example
 	 * ```typescript
+	 * // Uses preserve list from settings.yml automatically
 	 * const result = await ctx.noorm.db.truncate()
+	 *
+	 * // Override with explicit preserve list
+	 * const result = await ctx.noorm.db.truncate({ preserve: ['seeds'] })
+	 *
+	 * // Truncate only specific tables
+	 * const result = await ctx.noorm.db.truncate({ only: ['users', 'posts'] })
 	 * ```
 	 */
-	truncate(): Promise<TruncateResult>;
+	truncate(options?: TruncateOptions): Promise<TruncateResult>;
 	/**
 	 * Drop all database objects except noorm tracking tables.
 	 *

package/dist/index.js

@@ -23499,14 +23499,28 @@ var DbNamespace = class {
   /**
    * Wipe all data, keeping the schema intact.
    *
+   * User-provided preserve/only options take priority.
+   * Falls back to settings.teardown.preserveTables from settings.yml.
+   *
    * @example
    * ```typescript
+   * // Uses preserve list from settings.yml automatically
    * const result = await ctx.noorm.db.truncate()
+   *
+   * // Override with explicit preserve list
+   * const result = await ctx.noorm.db.truncate({ preserve: ['seeds'] })
+   *
+   * // Truncate only specific tables
+   * const result = await ctx.noorm.db.truncate({ only: ['users', 'posts'] })
    * ```
    */
-  async truncate() {
+  async truncate(options) {
     checkProtectedConfig(this.#state.config, "truncate", this.#state.options);
-    return truncateData(this.#kysely, this.#dialect);
+    const preserve = options?.preserve ?? this.#state.settings.teardown?.preserveTables;
+    return truncateData(this.#kysely, this.#dialect, {
+      ...options,
+      preserve
+    });
   }
   /**
    * Drop all database objects except noorm tracking tables.
@@ -23520,7 +23534,9 @@ var DbNamespace = class {
     checkProtectedConfig(this.#state.config, "teardown", this.#state.options);
     return teardownSchema(this.#kysely, this.#dialect, {
       configName: this.#state.config.name,
-      executedBy: formatIdentity(this.#state.identity)
+      executedBy: formatIdentity(this.#state.identity),
+      preserveTables: this.#state.settings.teardown?.preserveTables,
+      postScript: this.#state.settings.teardown?.postScript
     });
   }
   /**