realitydb 1.9.0 → 2.0.1

package/LICENSE

@@ -1,21 +1,80 @@
-MIT License
-
-Copyright (c) 2026 emkwambe
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+Business Source License 1.1
+
+Parameters
+
+Licensor:             Mpingo Systems Ltd (Eddy Mkwambe)
+Licensed Work:        RealityDB Sandbox
+                      The Licensed Work is (c) 2026 Mpingo Systems Ltd
+Additional Use Grant: You may make use of the Licensed Work, provided that
+                      you do not use the Licensed Work for a Synthetic Data
+                      Service, SQL Learning Service, or Database Simulation
+                      Service.
+
+                      A "Synthetic Data Service" is a commercial offering
+                      that allows third parties to access the functionality
+                      of the Licensed Work by generating synthetic database
+                      records, test data, or simulation environments.
+
+                      A "SQL Learning Service" is a commercial offering that
+                      allows third parties to practice SQL queries against
+                      auto-graded challenges using functionality substantially
+                      derived from the Licensed Work.
+
+                      A "Database Simulation Service" is a commercial offering
+                      that allows third parties to create or access simulated
+                      database environments with lifecycle-coherent data using
+                      functionality substantially derived from the Licensed Work.
+
+                      You may use the Licensed Work for internal testing,
+                      development, education, research, and any non-competing
+                      commercial purpose without restriction.
+
+Change Date:          March 31, 2030
+Change License:       Apache License, Version 2.0
+
+For information about alternative licensing arrangements for the Licensed Work,
+please contact: licensing@realitydb.dev
+
+Notice
+
+Business Source License 1.1 (the "License")
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited production
+use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.

package/dist/index.js

@@ -23297,23 +23297,42 @@ function escapeCsvField(value) {
 // ../../packages/generators/dist/exporters/sql.js
 var import_promises3 = require("fs/promises");
 var import_node_path3 = require("path");
-async function exportToSql(dataset, outputDir, tableOrder) {
+async function exportToSql(dataset, outputDir, tableOrder, options) {
   await (0, import_promises3.mkdir)(outputDir, { recursive: true });
+  const batchSize = options?.batchSize ?? 50;
   const lines = [];
-  lines.push("-- Generated by DataBox");
+  lines.push("-- =================================================================");
+  lines.push("-- Generated by RealityDB");
+  if (options?.templateName) {
+    lines.push(`-- Template: ${options.templateName}`);
+  }
   lines.push(`-- Seed: ${dataset.seed}`);
   lines.push(`-- Generated at: ${dataset.generatedAt}`);
+  lines.push("-- =================================================================");
+  lines.push("");
+  if (options?.ddl) {
+    lines.push("-- --- SCHEMA ---------------------------------------------------------");
+    lines.push("");
+    lines.push(options.ddl);
+    lines.push("");
+  }
+  lines.push("-- --- DATA -----------------------------------------------------------");
   lines.push("");
   for (const tableName of tableOrder) {
     const table = dataset.tables.get(tableName);
     if (!table || table.rows.length === 0)
       continue;
     const quotedColumns = table.columns.map((c) => `"${c}"`).join(", ");
-    for (const row of table.rows) {
-      const values = table.columns.map((col) => escapeSqlValue(row[col])).join(", ");
-      lines.push(`INSERT INTO "${tableName}" (${quotedColumns}) VALUES (${values});`);
+    for (let i = 0; i < table.rows.length; i += batchSize) {
+      const batch = table.rows.slice(i, i + batchSize);
+      const valueRows = batch.map((row) => {
+        const values = table.columns.map((col) => escapeSqlValue(row[col])).join(", ");
+        return `  (${values})`;
+      });
+      lines.push(`INSERT INTO "${tableName}" (${quotedColumns}) VALUES`);
+      lines.push(valueRows.join(",\n") + ";");
+      lines.push("");
     }
-    lines.push("");
   }
   const filePath = (0, import_node_path3.join)(outputDir, "seed.sql");
   await (0, import_promises3.writeFile)(filePath, lines.join("\n"), "utf-8");
@@ -24692,10 +24711,10 @@ function exportRealityPack(dataset, plan, schema, options) {
     }))
   };
   const packDataset = { tables: {} };
-  for (const [tableName, table] of dataset.tables) {
+  for (const [tableName, table] of Array.from(dataset.tables.entries())) {
     packDataset.tables[tableName] = {
-      columns: table.columns,
-      rows: table.rows,
+      columns: [...table.columns],
+      rows: table.rows.map((row) => ({ ...row })),
       rowCount: table.rowCount
     };
   }
@@ -27940,8 +27959,8 @@ function getSimulationProfile(name) {
 var saasTemplate = {
   name: "saas",
   version: "2.0",
-  description: "SaaS subscription business with organizations, users, plans, invoices, and payments",
-  targetTables: ["organizations", "users", "plans", "subscriptions", "invoices", "payments"],
+  description: "SaaS platform with 10 tables: organizations, users, plans, features, plan_features, subscriptions, invoices, payments, sessions, events",
+  targetTables: ["organizations", "users", "plans", "features", "plan_features", "subscriptions", "invoices", "payments", "sessions", "events"],
   tableConfigs: /* @__PURE__ */ new Map([
     ["organizations", {
       tableName: "organizations",
@@ -28098,7 +28117,7 @@ var saasTemplate = {
         {
           columnName: "trial_ends_at",
           strategy: { kind: "timestamp", options: { mode: "past" } },
-          description: "Nullable \u2014 null for non-trial subscriptions"
+          description: "Nullable \xC3\u0192\xC2\xA2\xC3\xA2\xE2\u20AC\u0161\xC2\xAC\xC3\xA2\xE2\u201A\xAC\xC2\x9D null for non-trial subscriptions"
         },
         {
           columnName: "current_period_start",
@@ -28116,7 +28135,7 @@ var saasTemplate = {
         {
           columnName: "canceled_at",
           strategy: { kind: "timestamp", options: { mode: "past" } },
-          description: "Nullable \u2014 should be null for active/trialing subscriptions"
+          description: "Nullable \xC3\u0192\xC2\xA2\xC3\xA2\xE2\u20AC\u0161\xC2\xAC\xC3\xA2\xE2\u201A\xAC\xC2\x9D should be null for active/trialing subscriptions"
         }
       ]
     }],
@@ -28157,7 +28176,7 @@ var saasTemplate = {
         {
           columnName: "paid_at",
           strategy: { kind: "timestamp", options: { mode: "past" } },
-          description: "Nullable \u2014 null for unpaid invoices"
+          description: "Nullable \xC3\u0192\xC2\xA2\xC3\xA2\xE2\u20AC\u0161\xC2\xAC\xC3\xA2\xE2\u201A\xAC\xC2\x9D null for unpaid invoices"
         },
         {
           columnName: "created_at",
@@ -28214,7 +28233,7 @@ var saasTemplate = {
               weights: [0.35, 0.3, 0.2, 0.15]
             }
           },
-          description: "Nullable \u2014 null for successful payments"
+          description: "Nullable \xC3\u0192\xC2\xA2\xC3\xA2\xE2\u20AC\u0161\xC2\xAC\xC3\xA2\xE2\u201A\xAC\xC2\x9D null for successful payments"
         },
         {
           columnName: "paid_at",
@@ -28222,6 +28241,50 @@ var saasTemplate = {
           strategy: { kind: "timestamp", options: { mode: "past" } }
         }
       ]
+    }],
+    ["features", {
+      tableName: "features",
+      matchPattern: ["features", "*feature*"],
+      rowCountMultiplier: 0.02,
+      columnOverrides: [
+        { columnName: "name", strategy: { kind: "text", options: { mode: "short" } } },
+        { columnName: "category", strategy: { kind: "enum", options: { values: ["core", "analytics", "security", "integration"], weights: [0.35, 0.25, 0.2, 0.2] } } },
+        { columnName: "created_at", strategy: { kind: "timestamp", options: { mode: "past" } } }
+      ]
+    }],
+    ["plan_features", {
+      tableName: "plan_features",
+      matchPattern: ["plan_features", "*plan_feature*"],
+      rowCountMultiplier: 0.06,
+      columnOverrides: [
+        { columnName: "enabled", strategy: { kind: "boolean" } },
+        { columnName: "limit_value", strategy: { kind: "integer", options: { min: 0, max: 1e4 } } },
+        { columnName: "created_at", strategy: { kind: "timestamp", options: { mode: "past" } } }
+      ]
+    }],
+    ["sessions", {
+      tableName: "sessions",
+      matchPattern: ["sessions", "*session*"],
+      rowCountMultiplier: 8,
+      columnOverrides: [
+        { columnName: "started_at", strategy: { kind: "timestamp", options: { mode: "past" } } },
+        { columnName: "ended_at", strategy: { kind: "timestamp", options: { mode: "recent" } } },
+        { columnName: "duration_seconds", strategy: { kind: "integer", options: { min: 10, max: 14400 } } },
+        { columnName: "ip_address", strategy: { kind: "text", options: { mode: "short" } } },
+        { columnName: "user_agent", strategy: { kind: "text" } },
+        { columnName: "country", strategy: { kind: "enum", options: { values: ["US", "UK", "CA", "DE", "FR", "AU", "IN", "BR"], weights: [0.5, 0.1, 0.08, 0.06, 0.05, 0.04, 0.04, 0.03] } } },
+        { columnName: "created_at", strategy: { kind: "timestamp", options: { mode: "past" } } }
+      ]
+    }],
+    ["events", {
+      tableName: "events",
+      matchPattern: ["events", "*event*"],
+      rowCountMultiplier: 10,
+      columnOverrides: [
+        { columnName: "event_type", strategy: { kind: "enum", options: { values: ["page_view", "button_click", "api_call", "feature_use", "error", "search"], weights: [0.4, 0.2, 0.15, 0.12, 0.05, 0.08] } } },
+        { columnName: "event_name", strategy: { kind: "text", options: { mode: "short" } } },
+        { columnName: "created_at", strategy: { kind: "timestamp", options: { mode: "recent" } } }
+      ]
     }]
   ])
 };
@@ -28230,8 +28293,8 @@ var saasTemplate = {
 var ecommerceTemplate = {
   name: "ecommerce",
   version: "2.0",
-  description: "E-commerce store with categories, products, orders, and reviews",
-  targetTables: ["customers", "categories", "products", "orders", "order_items", "reviews"],
+  description: "E-commerce platform with 12 tables: customers, categories, products, orders, order_items, reviews, sessions, cart_items, payments, refunds, shipments, disputes",
+  targetTables: ["customers", "categories", "products", "orders", "order_items", "reviews", "sessions", "cart_items", "payments", "refunds", "shipments", "disputes"],
   tableConfigs: /* @__PURE__ */ new Map([
     ["customers", {
       tableName: "customers",
@@ -28340,7 +28403,7 @@ var ecommerceTemplate = {
         {
           columnName: "compare_at_price_cents",
           strategy: { kind: "money", options: { min: 0, max: 2e5 } },
-          description: "Nullable \u2014 original price before discount"
+          description: "Nullable \xC3\xA2\xE2\u201A\xAC\xE2\u20AC\x9D original price before discount"
         },
         {
           columnName: "brand",
@@ -28426,13 +28489,13 @@ var ecommerceTemplate = {
           columnName: "shipped_at",
           matchPattern: ["shipped_at", "ship_date"],
           strategy: { kind: "timestamp", options: { mode: "past" } },
-          description: "Nullable \u2014 null for pending/processing orders"
+          description: "Nullable \xC3\xA2\xE2\u201A\xAC\xE2\u20AC\x9D null for pending/processing orders"
         },
         {
           columnName: "delivered_at",
           matchPattern: ["delivered_at", "delivery_date"],
           strategy: { kind: "timestamp", options: { mode: "past" } },
-          description: "Nullable \u2014 null for non-delivered orders"
+          description: "Nullable \xC3\xA2\xE2\u201A\xAC\xE2\u20AC\x9D null for non-delivered orders"
         }
       ]
     }],
@@ -28484,6 +28547,76 @@ var ecommerceTemplate = {
           strategy: { kind: "timestamp", options: { mode: "past" } }
         }
       ]
+    }],
+    ["sessions", {
+      tableName: "sessions",
+      matchPattern: ["sessions", "*session*"],
+      rowCountMultiplier: 8,
+      columnOverrides: [
+        { columnName: "started_at", strategy: { kind: "timestamp", options: { mode: "past" } } },
+        { columnName: "ended_at", strategy: { kind: "timestamp", options: { mode: "recent" } } },
+        { columnName: "page_count", strategy: { kind: "integer", options: { min: 1, max: 50 } } },
+        { columnName: "device_type", strategy: { kind: "enum", options: { values: ["desktop", "mobile", "tablet"], weights: [0.45, 0.4, 0.15] } } },
+        { columnName: "utm_source", strategy: { kind: "enum", options: { values: ["direct", "google", "email", "facebook", "organic"], weights: [0.35, 0.25, 0.15, 0.1, 0.15] } } },
+        { columnName: "created_at", strategy: { kind: "timestamp", options: { mode: "past" } } }
+      ]
+    }],
+    ["cart_items", {
+      tableName: "cart_items",
+      matchPattern: ["cart_items", "*cart*"],
+      rowCountMultiplier: 8,
+      columnOverrides: [
+        { columnName: "quantity", strategy: { kind: "integer", options: { min: 1, max: 5 } } },
+        { columnName: "price_cents", strategy: { kind: "integer", options: { min: 499, max: 99999 } } },
+        { columnName: "added_at", strategy: { kind: "timestamp", options: { mode: "past" } } },
+        { columnName: "converted", strategy: { kind: "boolean" } },
+        { columnName: "created_at", strategy: { kind: "timestamp", options: { mode: "past" } } }
+      ]
+    }],
+    ["payments", {
+      tableName: "payments",
+      matchPattern: ["payments", "*payment*"],
+      rowCountMultiplier: 3,
+      columnOverrides: [
+        { columnName: "amount_cents", strategy: { kind: "integer", options: { min: 499, max: 2e5 } } },
+        { columnName: "method", strategy: { kind: "enum", options: { values: ["credit_card", "debit_card", "paypal", "apple_pay", "klarna"], weights: [0.55, 0.15, 0.15, 0.1, 0.05] } } },
+        { columnName: "status", strategy: { kind: "enum", options: { values: ["succeeded", "failed", "pending", "refunded"], weights: [0.8, 0.12, 0.03, 0.05] } } },
+        { columnName: "created_at", strategy: { kind: "timestamp", options: { mode: "past" } } }
+      ]
+    }],
+    ["refunds", {
+      tableName: "refunds",
+      matchPattern: ["refunds", "*refund*"],
+      rowCountMultiplier: 0.4,
+      columnOverrides: [
+        { columnName: "amount_cents", strategy: { kind: "integer", options: { min: 499, max: 1e5 } } },
+        { columnName: "reason", strategy: { kind: "enum", options: { values: ["defective", "wrong_item", "changed_mind", "late_delivery", "duplicate"], weights: [0.25, 0.2, 0.3, 0.15, 0.1] } } },
+        { columnName: "status", strategy: { kind: "enum", options: { values: ["processed", "pending", "denied"], weights: [0.7, 0.2, 0.1] } } },
+        { columnName: "created_at", strategy: { kind: "timestamp", options: { mode: "past" } } }
+      ]
+    }],
+    ["shipments", {
+      tableName: "shipments",
+      matchPattern: ["shipments", "*shipment*"],
+      rowCountMultiplier: 3,
+      columnOverrides: [
+        { columnName: "carrier", strategy: { kind: "enum", options: { values: ["fedex", "ups", "usps", "dhl"], weights: [0.3, 0.3, 0.25, 0.15] } } },
+        { columnName: "status", strategy: { kind: "enum", options: { values: ["delivered", "in_transit", "out_for_delivery", "exception", "label_created"], weights: [0.5, 0.25, 0.1, 0.1, 0.05] } } },
+        { columnName: "shipped_at", strategy: { kind: "timestamp", options: { mode: "past" } } },
+        { columnName: "created_at", strategy: { kind: "timestamp", options: { mode: "past" } } }
+      ]
+    }],
+    ["disputes", {
+      tableName: "disputes",
+      matchPattern: ["disputes", "*dispute*"],
+      rowCountMultiplier: 0.05,
+      columnOverrides: [
+        { columnName: "reason", strategy: { kind: "enum", options: { values: ["fraud", "not_received", "not_as_described", "duplicate", "other"], weights: [0.2, 0.3, 0.25, 0.1, 0.15] } } },
+        { columnName: "status", strategy: { kind: "enum", options: { values: ["open", "under_review", "won", "lost"], weights: [0.15, 0.25, 0.35, 0.25] } } },
+        { columnName: "amount_cents", strategy: { kind: "integer", options: { min: 499, max: 5e4 } } },
+        { columnName: "evidence_submitted", strategy: { kind: "boolean" } },
+        { columnName: "created_at", strategy: { kind: "timestamp", options: { mode: "past" } } }
+      ]
     }]
   ])
 };
@@ -28492,7 +28625,7 @@ var ecommerceTemplate = {
 var educationTemplate = {
   name: "education",
   version: "2.0",
-  description: "K-12 school system with teachers, classes, students, grades, and attendance",
+  description: "K-12 school system with 6 tables: teachers, classes, students, enrollments, grades, attendance",
   targetTables: ["teachers", "classes", "students", "enrollments", "grades", "attendance"],
   tableConfigs: /* @__PURE__ */ new Map([
     ["teachers", {
@@ -28762,8 +28895,8 @@ var educationTemplate = {
 var fintechTemplate = {
   name: "fintech",
   version: "2.0",
-  description: "Financial services with accounts, transactions, fraud alerts, settlements, and chargebacks",
-  targetTables: ["accounts", "transactions", "fraud_alerts", "settlements", "chargebacks"],
+  description: "Financial platform with 10 tables: accounts, transactions, transfers, cards, authorizations, settlements, fraud_alerts, fraud_investigations, chargebacks, compliance_checks",
+  targetTables: ["accounts", "transactions", "fraud_alerts", "settlements", "chargebacks", "transfers", "cards", "authorizations", "fraud_investigations", "compliance_checks"],
   tableConfigs: /* @__PURE__ */ new Map([
     ["accounts", {
       tableName: "accounts",
@@ -28831,7 +28964,7 @@ var fintechTemplate = {
         {
           columnName: "closed_at",
           strategy: { kind: "timestamp", options: { mode: "past" } },
-          description: "Nullable \u2014 null for active accounts"
+          description: "Nullable \xC3\u0192\xC2\xA2\xC3\xA2\xE2\u20AC\u0161\xC2\xAC\xC3\xA2\xE2\u201A\xAC\xC2\x9D null for active accounts"
         }
       ]
     }],
@@ -28952,7 +29085,7 @@ var fintechTemplate = {
         {
           columnName: "resolved_at",
           strategy: { kind: "timestamp", options: { mode: "past" } },
-          description: "Nullable \u2014 null for open/investigating alerts"
+          description: "Nullable \xC3\u0192\xC2\xA2\xC3\xA2\xE2\u20AC\u0161\xC2\xAC\xC3\xA2\xE2\u201A\xAC\xC2\x9D null for open/investigating alerts"
         }
       ]
     }],
@@ -28988,7 +29121,7 @@ var fintechTemplate = {
         {
           columnName: "settled_at",
           strategy: { kind: "timestamp", options: { mode: "past" } },
-          description: "Nullable \u2014 null for pending settlements"
+          description: "Nullable \xC3\u0192\xC2\xA2\xC3\xA2\xE2\u20AC\u0161\xC2\xAC\xC3\xA2\xE2\u201A\xAC\xC2\x9D null for pending settlements"
         },
         {
           columnName: "created_at",
@@ -29032,9 +29165,70 @@ var fintechTemplate = {
         {
           columnName: "resolved_at",
           strategy: { kind: "timestamp", options: { mode: "past" } },
-          description: "Nullable \u2014 null for open/under_review chargebacks"
+          description: "Nullable \xC3\u0192\xC2\xA2\xC3\xA2\xE2\u20AC\u0161\xC2\xAC\xC3\xA2\xE2\u201A\xAC\xC2\x9D null for open/under_review chargebacks"
         }
       ]
+    }],
+    ["transfers", {
+      tableName: "transfers",
+      matchPattern: ["transfers", "*transfer*"],
+      rowCountMultiplier: 5,
+      columnOverrides: [
+        { columnName: "amount_cents", strategy: { kind: "integer", options: { min: 100, max: 5e6 } } },
+        { columnName: "status", strategy: { kind: "enum", options: { values: ["completed", "pending", "failed", "cancelled"], weights: [0.75, 0.12, 0.08, 0.05] } } },
+        { columnName: "reference", strategy: { kind: "text", options: { mode: "short" } } },
+        { columnName: "created_at", strategy: { kind: "timestamp", options: { mode: "past" } } }
+      ]
+    }],
+    ["cards", {
+      tableName: "cards",
+      matchPattern: ["cards", "*card*"],
+      rowCountMultiplier: 2.5,
+      columnOverrides: [
+        { columnName: "card_number_last_four", strategy: { kind: "text", options: { mode: "short" } } },
+        { columnName: "card_type", strategy: { kind: "enum", options: { values: ["debit", "credit"], weights: [0.6, 0.4] } } },
+        { columnName: "status", strategy: { kind: "enum", options: { values: ["active", "blocked", "expired", "cancelled"], weights: [0.75, 0.08, 0.12, 0.05] } } },
+        { columnName: "daily_limit_cents", strategy: { kind: "integer", options: { min: 5e4, max: 1e6 } } },
+        { columnName: "expires_at", strategy: { kind: "timestamp", options: { mode: "recent" } } },
+        { columnName: "created_at", strategy: { kind: "timestamp", options: { mode: "past" } } }
+      ]
+    }],
+    ["authorizations", {
+      tableName: "authorizations",
+      matchPattern: ["authorizations", "*authorization*", "*auth*"],
+      rowCountMultiplier: 8,
+      columnOverrides: [
+        { columnName: "merchant_name", strategy: { kind: "company_name" } },
+        { columnName: "amount_cents", strategy: { kind: "integer", options: { min: 100, max: 5e5 } } },
+        { columnName: "status", strategy: { kind: "enum", options: { values: ["approved", "declined", "reversed"], weights: [0.85, 0.1, 0.05] } } },
+        { columnName: "decline_reason", strategy: { kind: "enum", options: { values: ["insufficient_funds", "card_blocked", "suspicious_activity", "expired_card", "limit_exceeded"], weights: [0.3, 0.2, 0.25, 0.1, 0.15] } } },
+        { columnName: "authorized_at", strategy: { kind: "timestamp", options: { mode: "past" } } },
+        { columnName: "created_at", strategy: { kind: "timestamp", options: { mode: "past" } } }
+      ]
+    }],
+    ["fraud_investigations", {
+      tableName: "fraud_investigations",
+      matchPattern: ["fraud_investigations", "*investigation*"],
+      rowCountMultiplier: 0.2,
+      columnOverrides: [
+        { columnName: "investigator_notes", strategy: { kind: "text" } },
+        { columnName: "outcome", strategy: { kind: "enum", options: { values: ["confirmed_fraud", "false_positive", "inconclusive"], weights: [0.3, 0.5, 0.2] } } },
+        { columnName: "amount_recovered_cents", strategy: { kind: "integer", options: { min: 0, max: 5e5 } } },
+        { columnName: "closed_at", strategy: { kind: "timestamp", options: { mode: "recent" } } },
+        { columnName: "created_at", strategy: { kind: "timestamp", options: { mode: "past" } } }
+      ]
+    }],
+    ["compliance_checks", {
+      tableName: "compliance_checks",
+      matchPattern: ["compliance_checks", "*compliance*"],
+      rowCountMultiplier: 2,
+      columnOverrides: [
+        { columnName: "check_type", strategy: { kind: "enum", options: { values: ["kyc_verification", "aml_screening", "pep_check", "sanctions_check"], weights: [0.35, 0.3, 0.2, 0.15] } } },
+        { columnName: "result", strategy: { kind: "enum", options: { values: ["pass", "fail", "review_needed"], weights: [0.7, 0.1, 0.2] } } },
+        { columnName: "notes", strategy: { kind: "text" } },
+        { columnName: "performed_at", strategy: { kind: "timestamp", options: { mode: "past" } } },
+        { columnName: "created_at", strategy: { kind: "timestamp", options: { mode: "past" } } }
+      ]
     }]
   ])
 };
@@ -29043,8 +29237,8 @@ var fintechTemplate = {
 var healthcareTemplate = {
   name: "healthcare",
   version: "2.0",
-  description: "Healthcare system with patients, providers, encounters, diagnoses, billing, medications, and vitals",
-  targetTables: ["patients", "providers", "encounters", "diagnoses", "billing", "medications", "vitals"],
+  description: "Healthcare network with 13 tables: patients, providers, encounters, diagnoses, procedures, prescriptions, lab_orders, lab_results, vitals, billing, medications, insurance_claims, claim_payments",
+  targetTables: ["patients", "providers", "encounters", "diagnoses", "billing", "medications", "vitals", "procedures", "prescriptions", "lab_orders", "lab_results", "insurance_claims", "claim_payments"],
   tableConfigs: /* @__PURE__ */ new Map([
     ["patients", {
       tableName: "patients",
@@ -29204,12 +29398,12 @@ var healthcareTemplate = {
         {
           columnName: "checked_in_at",
           strategy: { kind: "timestamp", options: { mode: "past" } },
-          description: "Nullable \u2014 null for scheduled/canceled encounters"
+          description: "Nullable \xC3\xA2\xE2\u201A\xAC\xE2\u20AC\x9D null for scheduled/canceled encounters"
         },
         {
           columnName: "discharged_at",
           strategy: { kind: "timestamp", options: { mode: "past" } },
-          description: "Nullable \u2014 null for non-completed encounters"
+          description: "Nullable \xC3\xA2\xE2\u201A\xAC\xE2\u20AC\x9D null for non-completed encounters"
         }
       ]
     }],
@@ -29308,7 +29502,7 @@ var healthcareTemplate = {
         {
           columnName: "paid_at",
           strategy: { kind: "timestamp", options: { mode: "past" } },
-          description: "Nullable \u2014 null for unpaid bills"
+          description: "Nullable \xC3\xA2\xE2\u201A\xAC\xE2\u20AC\x9D null for unpaid bills"
         }
       ]
     }],
@@ -29363,7 +29557,7 @@ var healthcareTemplate = {
         {
           columnName: "end_date",
           strategy: { kind: "timestamp", options: { mode: "past" } },
-          description: "Nullable \u2014 null for ongoing medications"
+          description: "Nullable \xC3\xA2\xE2\u201A\xAC\xE2\u20AC\x9D null for ongoing medications"
         },
         {
           columnName: "status",
@@ -29411,6 +29605,85 @@ var healthcareTemplate = {
           strategy: { kind: "timestamp", options: { mode: "past" } }
         }
       ]
+    }],
+    ["procedures", {
+      tableName: "procedures",
+      matchPattern: ["procedures", "*procedure*"],
+      rowCountMultiplier: 5,
+      columnOverrides: [
+        { columnName: "cpt_code", strategy: { kind: "text", options: { mode: "short" } } },
+        { columnName: "procedure_name", strategy: { kind: "text" } },
+        { columnName: "status", strategy: { kind: "enum", options: { values: ["completed", "scheduled", "cancelled"], weights: [0.7, 0.2, 0.1] } } },
+        { columnName: "performed_at", strategy: { kind: "timestamp", options: { mode: "past" } } },
+        { columnName: "created_at", strategy: { kind: "timestamp", options: { mode: "past" } } }
+      ]
+    }],
+    ["prescriptions", {
+      tableName: "prescriptions",
+      matchPattern: ["prescriptions", "*prescription*"],
+      rowCountMultiplier: 8,
+      columnOverrides: [
+        { columnName: "dosage", strategy: { kind: "text", options: { mode: "short" } } },
+        { columnName: "frequency", strategy: { kind: "enum", options: { values: ["once_daily", "twice_daily", "three_times_daily", "as_needed", "weekly"], weights: [0.35, 0.25, 0.15, 0.15, 0.1] } } },
+        { columnName: "duration_days", strategy: { kind: "integer", options: { min: 5, max: 365 } } },
+        { columnName: "refills_remaining", strategy: { kind: "integer", options: { min: 0, max: 12 } } },
+        { columnName: "status", strategy: { kind: "enum", options: { values: ["active", "completed", "cancelled", "expired"], weights: [0.45, 0.3, 0.1, 0.15] } } },
+        { columnName: "prescribed_at", strategy: { kind: "timestamp", options: { mode: "past" } } },
+        { columnName: "created_at", strategy: { kind: "timestamp", options: { mode: "past" } } }
+      ]
+    }],
+    ["lab_orders", {
+      tableName: "lab_orders",
+      matchPattern: ["lab_orders", "*lab_order*"],
+      rowCountMultiplier: 4,
+      columnOverrides: [
+        { columnName: "test_name", strategy: { kind: "text" } },
+        { columnName: "priority", strategy: { kind: "enum", options: { values: ["routine", "urgent", "stat"], weights: [0.7, 0.2, 0.1] } } },
+        { columnName: "status", strategy: { kind: "enum", options: { values: ["ordered", "collected", "resulted", "cancelled"], weights: [0.15, 0.1, 0.65, 0.1] } } },
+        { columnName: "ordered_at", strategy: { kind: "timestamp", options: { mode: "past" } } },
+        { columnName: "resulted_at", strategy: { kind: "timestamp", options: { mode: "recent" } } },
+        { columnName: "created_at", strategy: { kind: "timestamp", options: { mode: "past" } } }
+      ]
+    }],
+    ["lab_results", {
+      tableName: "lab_results",
+      matchPattern: ["lab_results", "*lab_result*"],
+      rowCountMultiplier: 10,
+      columnOverrides: [
+        { columnName: "component", strategy: { kind: "text", options: { mode: "short" } } },
+        { columnName: "value", strategy: { kind: "float", options: { min: 0.1, max: 500 } } },
+        { columnName: "unit", strategy: { kind: "enum", options: { values: ["mg/dL", "mmol/L", "g/dL", "mEq/L", "U/L", "ng/mL", "cells/uL"], weights: [0.2, 0.15, 0.15, 0.15, 0.15, 0.1, 0.1] } } },
+        { columnName: "reference_range", strategy: { kind: "text", options: { mode: "short" } } },
+        { columnName: "abnormal_flag", strategy: { kind: "enum", options: { values: ["normal", "low", "high", "critical"], weights: [0.65, 0.15, 0.15, 0.05] } } },
+        { columnName: "resulted_at", strategy: { kind: "timestamp", options: { mode: "recent" } } },
+        { columnName: "created_at", strategy: { kind: "timestamp", options: { mode: "past" } } }
+      ]
+    }],
+    ["insurance_claims", {
+      tableName: "insurance_claims",
+      matchPattern: ["insurance_claims", "*claim*"],
+      rowCountMultiplier: 6,
+      columnOverrides: [
+        { columnName: "total_charges_cents", strategy: { kind: "integer", options: { min: 5e3, max: 5e5 } } },
+        { columnName: "allowed_amount_cents", strategy: { kind: "integer", options: { min: 3e3, max: 4e5 } } },
+        { columnName: "patient_responsibility_cents", strategy: { kind: "integer", options: { min: 0, max: 1e5 } } },
+        { columnName: "status", strategy: { kind: "enum", options: { values: ["submitted", "adjudicated", "paid", "denied", "appealed"], weights: [0.15, 0.1, 0.55, 0.12, 0.08] } } },
+        { columnName: "submitted_at", strategy: { kind: "timestamp", options: { mode: "past" } } },
+        { columnName: "paid_at", strategy: { kind: "timestamp", options: { mode: "recent" } } },
+        { columnName: "created_at", strategy: { kind: "timestamp", options: { mode: "past" } } }
+      ]
+    }],
+    ["claim_payments", {
+      tableName: "claim_payments",
+      matchPattern: ["claim_payments", "*claim_payment*"],
+      rowCountMultiplier: 4,
+      columnOverrides: [
+        { columnName: "amount_cents", strategy: { kind: "integer", options: { min: 1e3, max: 4e5 } } },
+        { columnName: "payment_method", strategy: { kind: "enum", options: { values: ["eft", "check", "wire"], weights: [0.7, 0.2, 0.1] } } },
+        { columnName: "status", strategy: { kind: "enum", options: { values: ["processed", "pending", "failed"], weights: [0.8, 0.12, 0.08] } } },
+        { columnName: "paid_at", strategy: { kind: "timestamp", options: { mode: "recent" } } },
+        { columnName: "created_at", strategy: { kind: "timestamp", options: { mode: "past" } } }
+      ]
     }]
   ])
 };
@@ -30095,8 +30368,9 @@ function buildGenerationPlan(schema, config, timelineConfig) {
   for (const fk of schema.foreignKeys) {
     fkBySource.set(`${fk.sourceTable}.${fk.sourceColumn}`, fk);
   }
+  const templateTargetSet = template ? new Set(template.targetTables) : null;
   const tables = schema.tables.map((table) => {
-    const tableForeignKeys = schema.foreignKeys.filter((fk) => fk.sourceTable === table.name);
+    const tableForeignKeys = schema.foreignKeys.filter((fk) => fk.sourceTable === table.name && (!templateTargetSet || templateTargetSet.has(fk.targetTable)));
     const dependencies = tableForeignKeys.map((fk) => fk.targetTable);
     const uniqueDeps = [...new Set(dependencies)];
     const tableConfig = template && registry && templateLookupName ? registry.matchTable(templateLookupName, table.name) : null;
@@ -30162,7 +30436,7 @@ function buildGenerationPlan(schema, config, timelineConfig) {
         isUnique: column.isUnique
       };
       const fk = fkBySource.get(`${table.name}.${column.name}`);
-      if (fk) {
+      if (fk && (!templateTargetSet || templateTargetSet.has(fk.targetTable))) {
         columnPlan.strategy = { kind: "foreign_key" };
         const ref = {
           referencedTable: fk.targetTable,
@@ -30192,7 +30466,7 @@ function buildGenerationPlan(schema, config, timelineConfig) {
         });
       }
     }
-    const rowCount = tableConfig?.rowCountMultiplier ? Math.round(defaultRowCount * tableConfig.rowCountMultiplier) : defaultRowCount;
+    const rowCount = tableConfig?.rowCountMultiplier ? Math.max(1, Math.round(defaultRowCount * tableConfig.rowCountMultiplier)) : defaultRowCount;
     const enabled = template ? tableConfig !== null : true;
     const tablePlan = {
       tableName: table.name,
@@ -30207,26 +30481,17 @@ function buildGenerationPlan(schema, config, timelineConfig) {
     return tablePlan;
   });
   if (template) {
-    const enabledSet = new Set(tables.filter((t) => t.enabled).map((t) => t.tableName));
-    let changed = true;
-    while (changed) {
-      changed = false;
-      for (const tablePlan of tables) {
-        if (tablePlan.enabled) {
-          for (const dep of tablePlan.dependencies) {
-            if (!enabledSet.has(dep)) {
-              enabledSet.add(dep);
-              const depPlan = tables.find((t) => t.tableName === dep);
-              if (depPlan && !depPlan.enabled) {
-                depPlan.enabled = true;
-                changed = true;
-              }
-            }
-          }
-        }
+    const targetSet = new Set(template.targetTables);
+    for (const tablePlan of tables) {
+      if (tablePlan.enabled && !targetSet.has(tablePlan.tableName)) {
+        tablePlan.enabled = false;
       }
     }
   }
+  const enabledNames = new Set(tables.filter((t) => t.enabled).map((t) => t.tableName));
+  const filteredTableOrder = tableOrder.filter((name) => enabledNames.has(name));
+  tableOrder.length = 0;
+  tableOrder.push(...filteredTableOrder);
   if (timelineConfig?.enabled) {
     const temporalConstraints = resolveTemporalConstraints(schema, schema.foreignKeys, config.template);
     for (const tablePlan of tables) {
@@ -31485,9 +31750,22 @@ async function exportDataset(config, options) {
       case "csv":
         files = await exportToCsv(dataset, outputDir);
         break;
-      case "sql":
-        files = await exportToSql(dataset, outputDir, plan.tableOrder);
+      case "sql": {
+        const templateTableSet = new Set(plan.tableOrder);
+        const scopedSchema = {
+          ...schema,
+          tables: schema.tables.filter((t) => templateTableSet.has(t.name)),
+          foreignKeys: schema.foreignKeys.filter((fk) => templateTableSet.has(fk.sourceTable) && templateTableSet.has(fk.targetTable))
+        };
+        scopedSchema.tableCount = scopedSchema.tables.length;
+        scopedSchema.foreignKeyCount = scopedSchema.foreignKeys.length;
+        files = await exportToSql(dataset, outputDir, plan.tableOrder, {
+          ddl: generateCreateTableDDL(scopedSchema),
+          batchSize: options?.batchSize ?? 50,
+          templateName: plan.config.templateName
+        });
         break;
+      }
       default:
         throw new Error(`Unknown export format: "${format}". Supported: json, csv, sql`);
     }
@@ -31672,15 +31950,92 @@ async function captureDatabase(config, options) {
       foreignKeyCount: filteredFKs.length
     };
     const ddl = generateCreateTableDDL(filteredSchema);
+    let aroundFilter;
+    if (options.around) {
+      aroundFilter = /* @__PURE__ */ new Map();
+      const { column: aroundCol, value: aroundVal } = options.around;
+      for (const table of filteredTables) {
+        const hasCol = table.columns.some((c) => c.name === aroundCol);
+        if (hasCol) {
+          aroundFilter.set(table.name, { column: aroundCol, values: /* @__PURE__ */ new Set([aroundVal]) });
+        }
+      }
+      for (const fk of filteredFKs) {
+        const sourceFilter = aroundFilter.get(fk.targetTable);
+        if (sourceFilter && sourceFilter.column === fk.targetColumn) {
+          aroundFilter.set(fk.sourceTable, { column: fk.sourceColumn, values: sourceFilter.values });
+        }
+      }
+    }
+    const detectionsByTable = /* @__PURE__ */ new Map();
+    let piiSummary;
+    if (options.safe) {
+      const mode = "gdpr";
+      for (const table of filteredTables) {
+        const tableForeignKeys = filteredFKs.filter((fk) => fk.sourceTable === table.name);
+        const detections = detectTablePII(table.columns, tableForeignKeys, table.name, mode);
+        detectionsByTable.set(table.name, detections);
+      }
+      let columnsDetected = 0;
+      let tablesAffected = 0;
+      const categoriesFound = /* @__PURE__ */ new Set();
+      for (const [, detections] of detectionsByTable) {
+        const piiCols = detections.filter((d) => d.shouldMask);
+        if (piiCols.length > 0) {
+          tablesAffected++;
+          columnsDetected += piiCols.length;
+          for (const d of piiCols) {
+            categoriesFound.add(d.category);
+          }
+        }
+      }
+      piiSummary = {
+        columnsDetected,
+        tablesAffected,
+        categoriesFound: Array.from(categoriesFound)
+      };
+    }
     const packDataset = { tables: {} };
     const tableDetails = [];
     let totalRows = 0;
+    const safeMode = options.safeMode ?? "mask";
+    const random = options.safe ? createSeededRandom(42) : void 0;
+    const tokenPrefix = options.safe && safeMode === "tokenize" ? generateTokenPrefix() : void 0;
     for (const tableName of tablesToCapture) {
       const tableSchema = filteredTables.find((t) => t.name === tableName);
       if (!tableSchema)
         continue;
       const columns = tableSchema.columns.map((c) => c.name);
-      const rows = await readTableRows(pool, tableName, columns);
+      let rows = await readTableRows(pool, tableName, columns);
+      const filter = aroundFilter?.get(tableName);
+      if (filter) {
+        rows = rows.filter((row) => {
+          const val = row[filter.column];
+          return val !== null && val !== void 0 && filter.values.has(String(val));
+        });
+      }
+      if (options.maxRows !== void 0 && rows.length > options.maxRows) {
+        rows = rows.slice(0, options.maxRows);
+      }
+      if (options.safe) {
+        const detections = detectionsByTable.get(tableName);
+        if (detections) {
+          const hasPII = detections.some((d) => d.shouldMask);
+          if (hasPII) {
+            if (safeMode === "tokenize" && tokenPrefix) {
+              const { tokenizedRows } = tokenizeTableRows(rows, detections, tableName, tokenPrefix);
+              rows = tokenizedRows;
+            } else if (safeMode === "redact") {
+              const redactDetections = detections.map((d) => d.shouldMask ? { ...d, maskStrategy: "redact" } : d);
+              const { maskedRows } = maskTableRows(rows, redactDetections, random, tableName);
+              rows = maskedRows;
+            } else {
+              const { maskedRows } = maskTableRows(rows, detections, random, tableName);
+              rows = maskedRows;
+            }
+          }
+        }
+      }
       const rowCount = rows.length;
       packDataset.tables[tableName] = {
         columns,
@@ -31725,6 +32080,7 @@ async function captureDatabase(config, options) {
       }
     };
     const masked = maskConnection(config.database.connectionString);
+    const safeModeValue = options.safe ? safeMode === "tokenize" ? "tokenized" : safeMode === "redact" ? "redacted" : "masked" : "raw";
     const pack = {
       format: "realitydb-pack",
       version: "1.0",
@@ -31736,7 +32092,9 @@ async function captureDatabase(config, options) {
         totalRows,
         tableCount: tablesToCapture.length,
         ddl,
-        capturedFrom: masked
+        capturedFrom: masked,
+        safeMode: safeModeValue,
+        piiSummary
       },
       schema: packSchema,
       plan,
@@ -31751,7 +32109,8 @@ async function captureDatabase(config, options) {
       totalRows,
       tableCount: tablesToCapture.length,
       durationMs,
-      tableDetails
+      tableDetails,
+      piiSummary
     };
   } finally {
     await closeConnection(pool);
@@ -33285,6 +33644,7 @@ async function exportCommand(options) {
       console.log("");
       console.log("Generating dataset...");
     }
+    const batchSize = options.batchSize ? parseInt(options.batchSize, 10) : void 0;
     const result = await exportDataset(config, {
       format,
       outputDir,
@@ -33294,7 +33654,8 @@ async function exportCommand(options) {
       timeline,
       scenarios: scenario,
       scenarioIntensity,
-      scenarioSchedule: options.scenarioSchedule
+      scenarioSchedule: options.scenarioSchedule,
+      batchSize
     });
     const durationMs = Math.round(performance.now() - start);
     if (options.ci) {
@@ -33737,6 +34098,18 @@ async function captureCommand(options) {
     const config = await loadConfig(options.configPath);
     const masked = maskConnectionString(config.database.connectionString);
     const tables = options.tables ? options.tables.split(",").map((t) => t.trim()).filter((t) => t.length > 0) : void 0;
+    const safeMode = options.safe ? ["mask", "tokenize", "redact"].includes(options.safeMode ?? "") ? options.safeMode : "mask" : void 0;
+    const maxRows = options.maxRows ? parseInt(options.maxRows, 10) : void 0;
+    let around;
+    if (options.around) {
+      const eqIdx = options.around.indexOf("=");
+      if (eqIdx > 0) {
+        around = {
+          column: options.around.substring(0, eqIdx),
+          value: options.around.substring(eqIdx + 1)
+        };
+      }
+    }
     if (!options.ci) {
       console.log("");
       console.log("RealityDB Capture");
@@ -33746,6 +34119,15 @@ async function captureCommand(options) {
       if (tables) {
         console.log(`Tables: ${tables.join(", ")}`);
       }
+      if (options.safe) {
+        console.log(`Safe mode: ${safeMode} (PII will be sanitized)`);
+      }
+      if (maxRows !== void 0) {
+        console.log(`Max rows per table: ${maxRows}`);
+      }
+      if (around) {
+        console.log("");
+      }
       console.log("");
       console.log("Capturing...");
     }
@@ -33753,7 +34135,11 @@ async function captureCommand(options) {
       name: options.name,
       description: options.description,
       tables,
-      outputDir: options.output
+      outputDir: options.output,
+      safe: options.safe,
+      safeMode,
+      maxRows,
+      around
     });
     const durationMs = Math.round(performance.now() - start);
     if (options.ci) {
@@ -33769,6 +34155,8 @@ async function captureCommand(options) {
           filePath: result.filePath,
           tableCount: result.tableCount,
           totalRows: result.totalRows,
+          safeMode: result.pack.metadata.safeMode,
+          piiSummary: result.piiSummary,
           tables: result.tableDetails.map((t) => ({
             name: t.name,
             rowCount: t.rowCount
@@ -33778,6 +34166,21 @@ async function captureCommand(options) {
       }));
       return;
     }
+    if (options.safe && result.piiSummary) {
+      const { columnsDetected, tablesAffected, categoriesFound } = result.piiSummary;
+      if (columnsDetected > 0) {
+        console.log(`PII detected: ${columnsDetected} columns across ${tablesAffected} tables. Sanitizing...`);
+        console.log(`  Categories: ${categoriesFound.join(", ")}`);
+        console.log("");
+      } else {
+        console.log("No PII detected \u2014 data captured as-is.");
+        console.log("");
+      }
+    }
+    if (around) {
+      console.log(`Capturing rows related to ${around.column}=${around.value} across ${result.tableCount} tables`);
+      console.log("");
+    }
     for (const table of result.tableDetails) {
       console.log(`  ${table.name}: ${table.rowCount} rows`);
     }
@@ -33785,6 +34188,9 @@ async function captureCommand(options) {
     const sizeKb = Math.round(fileStat.size / 1024);
     console.log("");
     console.log(`Captured: ${result.filePath} (${sizeKb} KB)`);
+    if (options.safe) {
+      console.log(`Privacy: PII sanitized (${safeMode} mode). Safe to share.`);
+    }
     console.log("Schema DDL included. Share this file to reproduce the environment.");
     console.log("");
   } catch (err) {
@@ -33915,6 +34321,19 @@ var VERSION9 = "0.10.0";
 function isUrl(input) {
   return input.startsWith("http://") || input.startsWith("https://");
 }
+function displaySafeModeStatus(safeMode) {
+  if (!safeMode) {
+    console.warn("Note: This pack was captured before privacy-safe mode was available");
+  } else if (safeMode === "raw") {
+    console.log("WARNING: This pack contains raw (unsanitized) data");
+  } else if (safeMode === "masked") {
+    console.log("This pack was captured with PII masking");
+  } else if (safeMode === "tokenized") {
+    console.log("This pack was captured with PII tokenization");
+  } else if (safeMode === "redacted") {
+    console.log("This pack was captured with PII redaction");
+  }
+}
 async function loadCommand(filePath, options) {
   const start = performance.now();
   try {
@@ -33950,6 +34369,57 @@ async function loadCommand(filePath, options) {
       }
     }
     const pack = await loadRealityPack(localPath);
+    if (options.preview) {
+      const meta2 = pack.metadata;
+      const safeMode2 = meta2.safeMode;
+      const piiSummary = meta2.piiSummary;
+      if (options.ci) {
+        const tableNames = Object.keys(pack.dataset.tables);
+        const tableInfo = tableNames.map((name) => ({
+          name,
+          rowCount: pack.dataset.tables[name].rowCount
+        }));
+        console.log(formatCIOutput({
+          success: true,
+          command: "load",
+          version: VERSION9,
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          durationMs: Math.round(performance.now() - start),
+          data: {
+            packName: pack.metadata.name,
+            safeMode: safeMode2 ?? null,
+            piiSummary: piiSummary ?? null,
+            tableCount: pack.metadata.tableCount,
+            totalRows: pack.metadata.totalRows,
+            tables: tableInfo
+          }
+        }));
+        return;
+      }
+      console.log("");
+      console.log("Reality Pack Preview");
+      console.log("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550");
+      console.log(`Name: ${pack.metadata.name}`);
+      if (pack.metadata.description) {
+        console.log(`Description: ${pack.metadata.description}`);
+      }
+      console.log(`Tables: ${pack.metadata.tableCount}`);
+      console.log(`Total rows: ${pack.metadata.totalRows}`);
+      console.log("");
+      displaySafeModeStatus(safeMode2);
+      if (piiSummary) {
+        console.log(`  PII columns detected: ${piiSummary.columnsDetected}`);
+        console.log(`  Tables affected: ${piiSummary.tablesAffected}`);
+        console.log(`  Categories: ${piiSummary.categoriesFound.join(", ")}`);
+      }
+      console.log("");
+      console.log("Tables:");
+      for (const [name, tableData] of Object.entries(pack.dataset.tables)) {
+        console.log(`  ${name}: ${tableData.rowCount} rows`);
+      }
+      console.log("");
+      return;
+    }
     if (options.showDdl) {
       const ddl = pack.metadata.ddl;
       if (options.ci) {
@@ -33982,6 +34452,8 @@ async function loadCommand(filePath, options) {
     }
     const config = await loadConfig(options.configPath);
     const masked = maskConnectionString(config.database.connectionString);
+    const meta = pack.metadata;
+    const safeMode = meta.safeMode;
     if (!options.ci) {
       console.log("");
       console.log("RealityDB Load");
@@ -34001,6 +34473,8 @@ async function loadCommand(filePath, options) {
         console.log("Schema DDL: included");
       }
       console.log("");
+      displaySafeModeStatus(safeMode);
+      console.log("");
     }
     if (!options.ci && !options.confirm) {
       console.error("[realitydb] Load requires --confirm flag.");
@@ -34008,6 +34482,9 @@ async function loadCommand(filePath, options) {
       console.error("");
       console.error("To view the schema DDL first:");
       console.error(`  realitydb load ${filePath} --show-ddl`);
+      console.error("");
+      console.error("To preview pack contents:");
+      console.error(`  realitydb load ${filePath} --preview`);
       process.exit(1);
     }
     if (!options.ci) {
@@ -34026,6 +34503,7 @@ async function loadCommand(filePath, options) {
           database: masked,
           packName: pack.metadata.name,
           totalRows: result.totalRows,
+          safeMode: safeMode ?? null,
           source: isUrl(filePath) ? filePath : void 0,
           tables: result.insertResult.tables.map((t) => ({
             name: t.tableName,
@@ -34043,7 +34521,8 @@ async function loadCommand(filePath, options) {
     }
     const totalTime = (result.durationMs / 1e3).toFixed(1);
     console.log("");
-    console.log(`Load complete. ${result.totalRows} rows in ${totalTime}s`);
+    console.log(`Bug reproduction environment ready. ${result.insertResult.tables.length} tables, ${result.totalRows} rows loaded.`);
+    console.log(`Load complete in ${totalTime}s`);
     console.log("");
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
@@ -35664,7 +36143,7 @@ async function simulateWebhooksCommand(options) {
 }
 
 // src/cli.ts
-var VERSION17 = "1.9.0";
+var VERSION17 = "2.0.1";
 function run(argv) {
   const program2 = new Command();
   program2.name("realitydb").description("RealityDB -- Developer Reality Platform").version(VERSION17).option("--config <path>", "Path to config file").option("--ci", "CI mode: JSON output, no prompts, proper exit codes", false).option("--verbose", "Enable verbose output", false);
@@ -35687,7 +36166,7 @@ function run(argv) {
     const opts = program2.opts();
     await resetCommand({ ...cmdOpts, ci: opts.ci, configPath: opts.config });
   });
-  program2.command("export").description("Export generated data").option("--format <format>", "Output format (json|csv|sql)", "json").option("--output <dir>", "Output directory", "./.realitydb").option("--records <count>", "Number of records per table").option("--seed <number>", "Random seed for reproducibility").option("--template <name>", "Template to use").option("--timeline <duration>", 'Timeline duration (e.g., "12-months", "1-year")').option("--scenario <names>", "Scenarios to apply (comma-separated)").option("--scenario-intensity <level>", "Scenario intensity (low|medium|high)", "medium").option("--scenario-schedule <schedule>", 'Timeline-scheduled scenarios (e.g., "fraud-spike:month-6,churn-spike:month-9")').action(async (cmdOpts) => {
+  program2.command("export").description("Export generated data").option("--format <format>", "Output format (json|csv|sql)", "json").option("--output <dir>", "Output directory", "./.realitydb").option("--records <count>", "Number of records per table").option("--seed <number>", "Random seed for reproducibility").option("--template <name>", "Template to use").option("--timeline <duration>", 'Timeline duration (e.g., "12-months", "1-year")').option("--scenario <names>", "Scenarios to apply (comma-separated)").option("--scenario-intensity <level>", "Scenario intensity (low|medium|high)", "medium").option("--scenario-schedule <schedule>", 'Timeline-scheduled scenarios (e.g., "fraud-spike:month-6,churn-spike:month-9")').option("--batch-size <number>", "Rows per INSERT statement for SQL format (default: 50)").action(async (cmdOpts) => {
     const opts = program2.opts();
     await exportCommand({ ...cmdOpts, ci: opts.ci, configPath: opts.config });
   });
@@ -35766,7 +36245,7 @@ function run(argv) {
     const opts = program2.opts();
     await simulateWebhooksCommand({ ...cmdOpts, ci: opts.ci, configPath: opts.config });
   });
-  program2.command("capture").description("Capture live database state into a Reality Pack").requiredOption("--name <name>", "Name for the captured pack").option("--description <desc>", "Pack description").option("--tables <tables>", "Comma-separated list of tables to capture").option("--output <dir>", "Output directory", ".").action(async (cmdOpts) => {
+  program2.command("capture").description("Capture live database state into a Reality Pack").requiredOption("--name <name>", "Name for the captured pack").option("--description <desc>", "Pack description").option("--tables <tables>", "Comma-separated list of tables to capture").option("--output <dir>", "Output directory", ".").option("--safe", "Enable privacy-safe capture (sanitize PII before writing)").option("--safe-mode <mode>", "PII sanitization mode: mask (default), tokenize, redact", "mask").option("--max-rows <count>", "Maximum rows to capture per table").option("--around <column=value>", "Capture rows related to a specific entity (follows FK chains)").action(async (cmdOpts) => {
     const opts = program2.opts();
     await captureCommand({ ...cmdOpts, ci: opts.ci, configPath: opts.config });
   });
@@ -35774,7 +36253,7 @@ function run(argv) {
     const opts = program2.opts();
     await shareCommand(filePath, { ...cmdOpts, ci: opts.ci, configPath: opts.config });
   });
-  program2.command("load <file>").description("Load a Reality Pack into the database (file path or URL)").option("--confirm", "Confirm import operation").option("--show-ddl", "Show schema DDL without importing").action(async (filePath, cmdOpts) => {
+  program2.command("load <file>").description("Load a Reality Pack into the database (file path or URL)").option("--confirm", "Confirm import operation").option("--show-ddl", "Show schema DDL without importing").option("--preview", "Preview pack contents without importing").action(async (filePath, cmdOpts) => {
     const opts = program2.opts();
     await loadCommand(filePath, { ...cmdOpts, ci: opts.ci, configPath: opts.config });
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "realitydb",
-  "version": "1.9.0",
+  "version": "2.0.1",
   "description": "Developer Reality Platform - realistic database environments from your schema",
   "license": "MIT",
   "keywords": [