@stndrds/schema 0.1.0-alpha.56 → 0.1.0-alpha.58

package/dist/index.mjs

@@ -4,6 +4,7 @@ import {
   AttributeNotFoundError,
   AuditService,
   AuthMethodSchema,
+  BEHAVIOR_PROPERTIES,
   BaseRepository,
   BaseService,
   ConcurrentModificationError,
@@ -16,8 +17,8 @@ import {
   CustomTabConfig,
   DEFAULT_LABEL_FALLBACK,
   DEFAULT_THEME,
-  DEFAULT_VALIDATION_MESSAGES,
   DRIVING_LICENSE,
+  DetailViewBuilder,
   DirectTableTabConfig,
   DocumentExecutor,
   DocumentGenerationNotConfiguredError,
@@ -37,6 +38,7 @@ import {
   EndNodeSchema,
   ExecutorRegistry,
   FRENCH_ID_CARD,
+  FeatureFlagsContextError,
   FileNotFoundError,
   FileService,
   FlowRowFieldSchema,
@@ -54,12 +56,15 @@ import {
   GrantNotFoundError,
   GrantRevokedError,
   GroupBuilder,
+  IDENTITY_PROPERTIES,
   InvalidPathError,
   InverseTableTabConfig,
   InvitationAlreadyAcceptedError,
   InvitationExpiredError,
   InvitationNotFoundError,
   InvitationRevokedError,
+  ListViewBuilder,
+  ListViewTabConfigBuilder,
   MaxDepthExceededError,
   NodePositionSchema,
   NoopCacheAdapter,
@@ -73,6 +78,7 @@ import {
   ObjectReferencedError,
   ObjectSchemaService,
   PASSPORT,
+  PRESENTATION_PROPERTIES,
   PROOF_OF_ADDRESS,
   PermissionService,
   PolicyRegistry,
@@ -144,9 +150,6 @@ import {
   addSchemaToContext,
   and,
   applyDefaultValues,
-  asTenantId,
-  asUserId,
-  attributeConfigSchemas,
   buildAuditChanges,
   buildPolicyContext,
   cacheKeys,
@@ -159,53 +162,25 @@ import {
   checkRecordModifyOrThrow,
   checkSharedObjectWriteAccess,
   checkbox,
-  checkboxConfigSchema,
   complete,
   computeLabel,
   computeLabelWithRelations,
-  computeRecordStatus,
-  createAttributeValidator,
-  createCheckboxValidator,
   createContextForCreate,
   createContextForDelete,
   createContextForRestore,
   createContextForUpdate,
-  createCurrencyValidator,
-  createDateValidator,
   createDefaultExecutorRegistry,
   createDefaultState,
-  createDraftValidator,
   createEmptyContext,
-  createFileValidator,
-  createFormAttributeValidator,
-  createFormulaValidator,
-  createLocationValidator,
   createMockAdapter,
-  createMultiRelationValidator,
-  createMultiselectValidator,
-  createNumberValidator,
-  createObjectValidator,
-  createPhoneValidator,
   createQueryBuilder,
-  createRatingValidator,
-  createRelationValidator,
-  createRichtextValidator,
-  createRollupValidator,
-  createSelectValidator,
-  createSingleRelationValidator,
   createStartTransition,
-  createStatusValidator,
-  createTextAreaValidator,
-  createTextValidator,
-  createUserValidator,
   currency,
-  currencyConfigSchema,
   date,
-  dateConfigSchema,
   defaultPolicyRegistry,
   defaultTtl,
+  detailView,
   document,
-  documentConfigSchema,
   enrichRecordsWithFormulas,
   enrichValuesForDisplay,
   enrichValuesWithSelectLabels,
@@ -226,23 +201,18 @@ import {
   extractRelationNames,
   extractRelationReferences,
   file,
-  fileConfigSchema,
   flattenRelationsForEval,
   formatAttributeValue,
   formatFormulaResult,
   formatRecord,
   formatRecords,
   formula,
-  formulaConfigSchema,
   generateCssVariables,
-  generateId,
-  generatePrefixedId,
-  generateTemplateName,
-  getAttributeConfigSchema,
   getContext,
   getContextValue,
   getDefaultExecutorRegistry,
-  getMissingRequiredAttributes,
+  getFeatureFlags,
+  getFeatureValue,
   getNodeOutputs,
   getPathDepth,
   getPolicy,
@@ -256,26 +226,31 @@ import {
   getTargetAttributeName,
   getTenantId,
   getUserId,
+  getViewSeedPreview,
   getViewSyncPreview,
   group,
   hasContext,
+  hasFeatureFlagsContext,
+  hasProperties,
   hasRelationReferences,
   hasSchemaContext,
   hashOptions,
   inValues,
   isAdvancedFormNode,
-  isConcurrentModificationError,
+  isBehaviorProperty,
   isConditionGroup,
   isConditionNode,
   isConditionRule,
   isDocumentNode,
   isEmpty,
   isEndNode,
+  isFeatureEnabled,
   isForbiddenError,
   isFormNode,
   isGrantExpired,
   isGrantRevoked,
   isGrantValid,
+  isIdentityProperty,
   isInstanceEvent,
   isInstanceTerminal,
   isInstanceWaiting,
@@ -287,8 +262,8 @@ import {
   isNodeEvent,
   isNotEmpty,
   isNotFoundError,
+  isPresentationProperty,
   isProtectedResourceError,
-  isRecordComplete,
   isSchemaError,
   isSimpleFormNode,
   isStartNode,
@@ -301,72 +276,125 @@ import {
   isValidationError,
   isWorkflowDefinition,
   isWorkflowPublished,
+  listView,
   location,
-  locationConfigSchema,
-  mergeFormToSlot,
   mergeWithDefaults,
   multiselect,
-  multiselectConfigSchema,
   neq,
   notesPolicy,
   number,
-  numberConfigSchema,
   object,
   or,
-  parseAttributeConfig,
   parsePath,
   pathHasManyCardinality,
   phone,
-  phoneConfigSchema,
   rating,
-  ratingConfigSchema,
   recalculateParentRollups,
   registry,
   relation,
-  relationConfigSchema,
   renderLabelExpression,
   resolveMultiplePaths,
   resolveSingleValue,
   richtext,
-  richtextConfigSchema,
   rollup,
-  rollupConfigSchema,
   runWithContext,
+  runWithFeatureFlags,
   runWithMergedSchemaContext,
   runWithSchemaContext,
-  safeParseAttributeConfig,
+  seedRegistryViews,
   select,
-  selectConfigSchema,
   setContextValue,
-  slugify,
   status,
-  statusConfigSchema,
   success,
   syncAll,
   syncNativeObjects,
   syncNativeViews,
   text,
-  textConfigSchema,
   textarea,
-  textareaConfigSchema,
+  toUndefinedIfEmpty,
   traversePath,
+  tryGetFeatureValue,
   user,
-  userConfigSchema,
-  validateAttribute,
-  validateAttributeConfig,
-  validateDraft,
-  validateDraftOrThrow,
   validateFormulaExpression,
-  validateObject,
-  validateObjectOrThrow,
   validatePath,
   verifyNativeObjectsSync,
   verifyNativeViewsSync,
+  verifyRegistryViewsSeeded,
   view,
   wait,
+  withFeatureFlags,
   withTenantContext,
   workflow
-} from "./chunk-LOOGQL6M.mjs";
+} from "./chunk-JRY236AO.mjs";
+import {
+  asTenantId,
+  asUserId,
+  generateId,
+  generatePrefixedId,
+  generateTemplateName,
+  indexBy,
+  slugify
+} from "./chunk-V2RPPE2Y.mjs";
+import {
+  DEFAULT_VALIDATION_MESSAGES,
+  attributeConfigSchemas,
+  checkboxConfigSchema,
+  computeRecordStatus,
+  createAttributeValidator,
+  createCheckboxValidator,
+  createCurrencyValidator,
+  createDateValidator,
+  createDraftValidator,
+  createFileValidator,
+  createFormAttributeValidator,
+  createFormulaValidator,
+  createLocationValidator,
+  createMultiRelationValidator,
+  createMultiselectValidator,
+  createNumberValidator,
+  createObjectValidator,
+  createPhoneValidator,
+  createRatingValidator,
+  createRelationValidator,
+  createRichtextValidator,
+  createRollupValidator,
+  createSelectValidator,
+  createSingleRelationValidator,
+  createStatusValidator,
+  createTextAreaValidator,
+  createTextValidator,
+  createUserValidator,
+  currencyConfigSchema,
+  dateConfigSchema,
+  documentConfigSchema,
+  fileConfigSchema,
+  formatZodErrors,
+  formulaConfigSchema,
+  getAttributeConfigSchema,
+  getMissingRequiredAttributes,
+  isRecordComplete,
+  locationConfigSchema,
+  multiselectConfigSchema,
+  numberConfigSchema,
+  parseAttributeConfig,
+  phoneConfigSchema,
+  ratingConfigSchema,
+  relationConfigSchema,
+  richtextConfigSchema,
+  rollupConfigSchema,
+  safeParseAttributeConfig,
+  selectConfigSchema,
+  statusConfigSchema,
+  textConfigSchema,
+  textareaConfigSchema,
+  userConfigSchema,
+  validateAttribute,
+  validateAttributeConfig,
+  validateDraft,
+  validateDraftOrThrow,
+  validateObject,
+  validateObjectOrThrow
+} from "./chunk-SV4BCGQU.mjs";
 import {
   ALL_SYSTEM_RESOURCES,
   DEFAULT_ROLES,
@@ -379,43 +407,7 @@ import {
 } from "./chunk-V5QXU2OK.mjs";
 import "./chunk-Y6FXYEAI.mjs";
 
-// src/types/document-generation.ts
-function isPdfTemplateSource(source) {
-  return source.type === "pdf";
-}
-function isDocxTemplateSource(source) {
-  return source.type === "docx";
-}
-
 // src/types/filters.ts
-function isAdvancedFilterState(state) {
-  return "groups" in state;
-}
-function toAdvancedFilterState(state) {
-  if (state.rules.length === 0) {
-    return {
-      combinator: state.combinator,
-      groups: []
-    };
-  }
-  return {
-    combinator: "and",
-    groups: [
-      {
-        id: crypto.randomUUID(),
-        combinator: state.combinator,
-        rules: state.rules
-      }
-    ]
-  };
-}
-function toSimpleFilterState(state) {
-  const allRules = state.groups.flatMap((group2) => group2.rules);
-  return {
-    combinator: state.combinator,
-    rules: allRules
-  };
-}
 var OPERATORS_BY_TYPE = {
   text: [
     "is",
@@ -503,6 +495,21 @@ function isSystemFlow(flow) {
 }
 
 // src/types/views.ts
+function isDetailView(view2) {
+  return view2.type === "detail";
+}
+function isListView(view2) {
+  return view2.type === "list";
+}
+function isCalendarView(view2) {
+  return view2.type === "calendar";
+}
+function isTimelineView(view2) {
+  return view2.type === "timeline";
+}
+function isGalleryView(view2) {
+  return view2.type === "gallery";
+}
 function isFormTab(tab) {
   return tab.type === "form";
 }
@@ -531,6 +538,523 @@ function isDocumentsTab(tab) {
   return tab.type === "documents";
 }
 
+// src/feature-flags/flag-builder.ts
+function validateFlagName(name) {
+  if (!/^[a-z][a-z0-9-]*[a-z0-9]$|^[a-z]$/.test(name)) {
+    throw new Error(
+      `Invalid flag name "${name}". Flag names must be kebab-case (e.g., "architect-mode", "ai-features").`
+    );
+  }
+}
+var BaseFlagBuilder = class {
+  constructor(name, valueType, defaultValue) {
+    validateFlagName(name);
+    this.flag = {
+      name,
+      valueType,
+      defaultValue,
+      allowedLevels: ["global", "tenant", "user"]
+    };
+  }
+  /**
+   * Set the human-readable label for the flag.
+   * Required - build() will throw if not set.
+   */
+  label(value) {
+    this.flag.label = value;
+    return this;
+  }
+  /**
+   * Set an optional description for the flag.
+   */
+  description(value) {
+    this.flag.description = value;
+    return this;
+  }
+  /**
+   * Set a category for grouping flags in UI.
+   */
+  category(value) {
+    this.flag.category = value;
+    return this;
+  }
+  /**
+   * Mark this flag as a system flag.
+   * System flags cannot be modified via API.
+   */
+  system() {
+    this.flag.system = true;
+    return this;
+  }
+  /**
+   * Restrict the flag to global and tenant levels only.
+   * Per-user overrides will not be allowed.
+   */
+  tenantScoped() {
+    this.flag.allowedLevels = ["global", "tenant"];
+    return this;
+  }
+  /**
+   * Restrict the flag to global level only.
+   * No tenant or user overrides will be allowed.
+   */
+  globalOnly() {
+    this.flag.allowedLevels = ["global"];
+    return this;
+  }
+  /**
+   * Set custom allowed levels.
+   */
+  allowedLevels(levels) {
+    this.flag.allowedLevels = levels;
+    return this;
+  }
+  /**
+   * Build the flag definition.
+   * @throws {Error} If label is not set
+   */
+  build() {
+    if (!this.flag.label) {
+      throw new Error(
+        `Flag "${this.flag.name}" must have a label. Use .label("Human-readable label").`
+      );
+    }
+    return this.flag;
+  }
+};
+var BooleanFlagBuilder = class extends BaseFlagBuilder {
+  constructor(name) {
+    super(name, "boolean", false);
+  }
+  /**
+   * Set the default value (default: false).
+   */
+  defaultValue(value) {
+    this.flag.defaultValue = value;
+    return this;
+  }
+  /**
+   * Set the default to true.
+   * Shorthand for .defaultValue(true).
+   */
+  enabledByDefault() {
+    this.flag.defaultValue = true;
+    return this;
+  }
+};
+var StringFlagBuilder = class extends BaseFlagBuilder {
+  constructor(name) {
+    super(name, "string", "");
+  }
+  /**
+   * Set the default value.
+   */
+  defaultValue(value) {
+    this.flag.defaultValue = value;
+    return this;
+  }
+};
+var NumberFlagBuilder = class extends BaseFlagBuilder {
+  constructor(name) {
+    super(name, "number", 0);
+  }
+  /**
+   * Set the default value.
+   */
+  defaultValue(value) {
+    this.flag.defaultValue = value;
+    return this;
+  }
+};
+var JsonFlagBuilder = class extends BaseFlagBuilder {
+  constructor(name, defaultValue) {
+    super(name, "json", defaultValue);
+  }
+  /**
+   * Set the default value.
+   */
+  defaultValue(value) {
+    this.flag.defaultValue = value;
+    return this;
+  }
+};
+function booleanFlag(name) {
+  return new BooleanFlagBuilder(name);
+}
+function stringFlag(name) {
+  return new StringFlagBuilder(name);
+}
+function numberFlag(name) {
+  return new NumberFlagBuilder(name);
+}
+function jsonFlag(name, defaultValue) {
+  return new JsonFlagBuilder(name, defaultValue);
+}
+
+// src/feature-flags/flag-registry.ts
+var FlagRegistry = class {
+  constructor() {
+    this.flags = /* @__PURE__ */ new Map();
+  }
+  /**
+   * Register a feature flag definition.
+   *
+   * @param flag - The flag definition to register
+   * @throws {Error} If a flag with the same name is already registered
+   *
+   * @example
+   * ```typescript
+   * registry.register(booleanFlag("my-feature")
+   *   .label("My Feature")
+   *   .build()
+   * );
+   * ```
+   */
+  register(flag) {
+    if (this.flags.has(flag.name)) {
+      throw new Error(`Flag "${flag.name}" is already registered. Each flag name must be unique.`);
+    }
+    this.flags.set(flag.name, flag);
+  }
+  /**
+   * Register multiple flags at once.
+   *
+   * @param flags - Array of flag definitions to register
+   */
+  registerAll(flags) {
+    for (const flag of flags) {
+      this.register(flag);
+    }
+  }
+  /**
+   * Get a flag definition by name.
+   *
+   * @param name - The flag name
+   * @returns The flag definition or undefined if not found
+   */
+  get(name) {
+    return this.flags.get(name);
+  }
+  /**
+   * Get a flag definition by name, throwing if not found.
+   *
+   * @param name - The flag name
+   * @returns The flag definition
+   * @throws {Error} If the flag is not registered
+   */
+  getOrThrow(name) {
+    const flag = this.get(name);
+    if (!flag) {
+      throw new Error(
+        `Flag "${name}" is not registered. Available flags: ${this.listNames().join(", ")}`
+      );
+    }
+    return flag;
+  }
+  /**
+   * Check if a flag is registered.
+   *
+   * @param name - The flag name
+   * @returns true if the flag is registered
+   */
+  has(name) {
+    return this.flags.has(name);
+  }
+  /**
+   * List all registered flag definitions.
+   *
+   * @returns Array of all flag definitions
+   */
+  list() {
+    return Array.from(this.flags.values());
+  }
+  /**
+   * List all registered flag names.
+   *
+   * @returns Array of flag names
+   */
+  listNames() {
+    return Array.from(this.flags.keys());
+  }
+  /**
+   * List flags filtered by category.
+   *
+   * @param category - The category to filter by
+   * @returns Array of flag definitions in the category
+   */
+  listByCategory(category) {
+    return this.list().filter((flag) => flag.category === category);
+  }
+  /**
+   * Get all unique categories.
+   *
+   * @returns Array of unique category names
+   */
+  getCategories() {
+    const categories = /* @__PURE__ */ new Set();
+    for (const flag of this.flags.values()) {
+      if (flag.category) {
+        categories.add(flag.category);
+      }
+    }
+    return Array.from(categories);
+  }
+  /**
+   * Get the default value for a flag.
+   *
+   * @param name - The flag name
+   * @returns The default value or undefined if flag not found
+   */
+  getDefaultValue(name) {
+    return this.get(name)?.defaultValue;
+  }
+  /**
+   * Get a map of all flag names to their default values.
+   *
+   * @returns Map of flag names to default values
+   */
+  getDefaults() {
+    const defaults = /* @__PURE__ */ new Map();
+    for (const [name, flag] of this.flags) {
+      defaults.set(name, flag.defaultValue);
+    }
+    return defaults;
+  }
+  /**
+   * Unregister a flag (mainly for testing).
+   *
+   * @param name - The flag name to unregister
+   * @returns true if the flag was removed, false if it didn't exist
+   */
+  unregister(name) {
+    return this.flags.delete(name);
+  }
+  /**
+   * Clear all registered flags (mainly for testing).
+   */
+  clear() {
+    this.flags.clear();
+  }
+  /**
+   * Get the number of registered flags.
+   */
+  get size() {
+    return this.flags.size;
+  }
+};
+var flagRegistry = new FlagRegistry();
+function createFlagRegistry() {
+  return new FlagRegistry();
+}
+
+// src/feature-flags/flag-service.ts
+var FlagService = class {
+  constructor(options) {
+    this.repository = options.repository;
+    this.registry = options.registry;
+    this.staticDefaults = new Map(options.staticDefaults?.map((d) => [d.name, d.value]) ?? []);
+  }
+  /**
+   * Resolve all flags for the current context.
+   * Returns a Map suitable for runWithFeatureFlags().
+   *
+   * @param context - Resolution context with tenant/user IDs
+   * @returns Map of flag names to resolved values
+   */
+  async resolveAll(context = {}) {
+    const resolved = /* @__PURE__ */ new Map();
+    const flagNames = /* @__PURE__ */ new Set();
+    for (const name of this.registry.listNames()) {
+      flagNames.add(name);
+    }
+    for (const name of this.staticDefaults.keys()) {
+      flagNames.add(name);
+    }
+    const overrides = this.repository ? await this.getAllOverrides(context) : { global: [], tenant: [], user: [] };
+    for (const name of flagNames) {
+      const value = this.resolveValue(name, overrides, context);
+      resolved.set(name, value);
+    }
+    return resolved;
+  }
+  /**
+   * Resolve a single flag with full metadata.
+   *
+   * @param flagName - The flag to resolve
+   * @param context - Resolution context
+   * @returns Resolved flag with source information
+   */
+  async resolve(flagName, context = {}) {
+    const overrides = this.repository ? await this.getAllOverrides(context) : { global: [], tenant: [], user: [] };
+    return this.resolveWithSource(flagName, overrides, context);
+  }
+  /**
+   * Quick check if a boolean flag is enabled.
+   *
+   * @param flagName - The flag to check
+   * @param context - Resolution context
+   * @returns true if the flag value is exactly true
+   */
+  async isEnabled(flagName, context = {}) {
+    const resolved = await this.resolve(flagName, context);
+    return resolved.value === true;
+  }
+  /**
+   * Get a flag value with type inference.
+   *
+   * @param flagName - The flag to get
+   * @param context - Resolution context
+   * @returns The resolved flag value
+   */
+  async getValue(flagName, context = {}) {
+    const resolved = await this.resolve(flagName, context);
+    return resolved.value;
+  }
+  /**
+   * Set an override for a flag.
+   *
+   * @param flagName - The flag to override
+   * @param level - The level of the override
+   * @param value - The override value
+   * @param options - Additional options
+   */
+  async setOverride(flagName, level, value, options = {}) {
+    if (!this.repository) {
+      throw new Error(
+        "Cannot set override: no FeatureFlagsRepository configured. Add featureFlags to your DatabaseAdapter to enable runtime overrides."
+      );
+    }
+    const flag = this.registry.get(flagName);
+    if (flag && !flag.allowedLevels.includes(level)) {
+      throw new Error(
+        `Flag "${flagName}" does not allow ${level}-level overrides. Allowed levels: ${flag.allowedLevels.join(", ")}`
+      );
+    }
+    if (flag?.system) {
+      throw new Error(`Flag "${flagName}" is a system flag and cannot be overridden via API.`);
+    }
+    await this.repository.setOverride({
+      flagName,
+      level,
+      value,
+      targetId: options.targetId,
+      expiresAt: options.expiresAt,
+      createdBy: options.createdBy
+    });
+  }
+  /**
+   * Delete an override.
+   *
+   * @param flagName - The flag name
+   * @param level - The level to delete
+   * @param targetId - Optional target ID for tenant/user level
+   */
+  async deleteOverride(flagName, level, targetId) {
+    if (!this.repository) {
+      throw new Error("Cannot delete override: no FeatureFlagsRepository configured.");
+    }
+    await this.repository.deleteOverride(flagName, level, targetId);
+  }
+  // ============================================================================
+  // PRIVATE HELPERS
+  // ============================================================================
+  /**
+   * Get all overrides organized by level.
+   */
+  async getAllOverrides(context) {
+    if (!this.repository) {
+      return { global: [], tenant: [], user: [] };
+    }
+    const [globalOverrides, tenantOverrides, userOverrides] = await Promise.all([
+      this.repository.getOverrides({ level: "global" }),
+      context.tenantId ? this.repository.getOverrides({ level: "tenant", targetId: context.tenantId }) : Promise.resolve([]),
+      context.userId ? this.repository.getOverrides({ level: "user", targetId: context.userId }) : Promise.resolve([])
+    ]);
+    return {
+      global: globalOverrides,
+      tenant: tenantOverrides,
+      user: userOverrides
+    };
+  }
+  /**
+   * Resolve a flag value from overrides and defaults.
+   */
+  resolveValue(flagName, overrides, context) {
+    const flag = this.registry.get(flagName);
+    const allowedLevels = flag?.allowedLevels ?? ["global", "tenant", "user"];
+    if (context.userId && allowedLevels.includes("user")) {
+      const userOverride = overrides.user.find((o) => o.flagName === flagName);
+      if (userOverride) return userOverride.value;
+    }
+    if (context.tenantId && allowedLevels.includes("tenant")) {
+      const tenantOverride = overrides.tenant.find((o) => o.flagName === flagName);
+      if (tenantOverride) return tenantOverride.value;
+    }
+    if (allowedLevels.includes("global")) {
+      const globalOverride = overrides.global.find((o) => o.flagName === flagName);
+      if (globalOverride) return globalOverride.value;
+    }
+    if (this.staticDefaults.has(flagName)) {
+      return this.staticDefaults.get(flagName);
+    }
+    return flag?.defaultValue;
+  }
+  /**
+   * Resolve a flag value with source information.
+   */
+  resolveWithSource(flagName, overrides, context) {
+    const flag = this.registry.get(flagName);
+    const allowedLevels = flag?.allowedLevels ?? ["global", "tenant", "user"];
+    if (context.userId && allowedLevels.includes("user")) {
+      const userOverride = overrides.user.find((o) => o.flagName === flagName);
+      if (userOverride) {
+        return {
+          name: flagName,
+          value: userOverride.value,
+          source: "user",
+          sourceId: context.userId
+        };
+      }
+    }
+    if (context.tenantId && allowedLevels.includes("tenant")) {
+      const tenantOverride = overrides.tenant.find((o) => o.flagName === flagName);
+      if (tenantOverride) {
+        return {
+          name: flagName,
+          value: tenantOverride.value,
+          source: "tenant",
+          sourceId: context.tenantId
+        };
+      }
+    }
+    if (allowedLevels.includes("global")) {
+      const globalOverride = overrides.global.find((o) => o.flagName === flagName);
+      if (globalOverride) {
+        return {
+          name: flagName,
+          value: globalOverride.value,
+          source: "global"
+        };
+      }
+    }
+    if (this.staticDefaults.has(flagName)) {
+      return {
+        name: flagName,
+        value: this.staticDefaults.get(flagName),
+        source: "default"
+      };
+    }
+    return {
+      name: flagName,
+      value: flag?.defaultValue ?? void 0,
+      source: "default"
+    };
+  }
+};
+function createFlagService(options) {
+  return new FlagService(options);
+}
+
 // src/native/notes.ts
 var NOTES = object({ name: "notes", label: "Note" }).pluralLabel("Notes").icon("file-text").description("Notes that can be linked to any record or used globally").system().labelExpression("{{ title }}").attribute(text({ name: "title", label: "Title" }).placeholder("Untitled").required()).attribute(richtext({ name: "content", label: "Content" }).required()).attribute(
   select({ name: "visibility", label: "Visibility" }).options([
@@ -545,12 +1069,12 @@ var ViewRegistry = class {
   constructor() {
     this.views = /* @__PURE__ */ new Map();
     this.byObject = /* @__PURE__ */ new Map();
+    this.byObjectAndType = /* @__PURE__ */ new Map();
   }
   /**
-   * Register a native view
+   * Register a view
    * @param viewOrViews - Single view or array of views
-   * @throws Error if view is not marked as system
-   * @throws Error if view with same name already exists for the object
+   * @throws Error if view with same name and type already exists for the object
    */
   register(viewOrViews) {
     const views = Array.isArray(viewOrViews) ? viewOrViews : [viewOrViews];
@@ -560,22 +1084,20 @@ var ViewRegistry = class {
     return this;
   }
   registerSingle(view2) {
-    if (!view2.system) {
-      throw new Error(
-        `[ViewRegistry] View "${view2.name}" for object "${view2.object}" is missing system flag.
-Only system views can be registered. Add .system() to your view builder.`
-      );
-    }
-    const key = this.makeKey(view2.object, view2.name);
+    const key = this.makeKey(view2.object, view2.name, view2.type);
     if (this.views.has(key)) {
       throw new Error(
-        `[ViewRegistry] Duplicate view name "${view2.name}" for object "${view2.object}"`
+        `[ViewRegistry] Duplicate view: "${view2.name}" (${view2.type}) for object "${view2.object}"`
       );
     }
     this.views.set(key, view2);
     const objectViews = this.byObject.get(view2.object) ?? [];
     objectViews.push(view2);
     this.byObject.set(view2.object, objectViews);
+    const typeKey = `${view2.object}:${view2.type}`;
+    const typeViews = this.byObjectAndType.get(typeKey) ?? [];
+    typeViews.push(view2);
+    this.byObjectAndType.set(typeKey, typeViews);
   }
   /**
    * Get all views for an object
@@ -584,19 +1106,29 @@ Only system views can be registered. Add .system() to your view builder.`
     return this.byObject.get(objectName) ?? [];
   }
   /**
-   * Get a specific view by object and view name
+   * Get views for an object filtered by type
    */
-  get(objectName, viewName) {
-    return this.views.get(this.makeKey(objectName, viewName));
+  getByObjectNameAndType(objectName, type) {
+    return this.byObjectAndType.get(`${objectName}:${type}`) ?? [];
+  }
+  /**
+   * Get a specific view by object, name, and type
+   */
+  get(objectName, viewName, type) {
+    if (type) {
+      return this.views.get(this.makeKey(objectName, viewName, type));
+    }
+    const objectViews = this.getByObjectName(objectName);
+    return objectViews.find((v) => v.name === viewName);
   }
   /**
    * Get a view or throw if not found
    */
-  getOrThrow(objectName, viewName) {
-    const view2 = this.get(objectName, viewName);
+  getOrThrow(objectName, viewName, type) {
+    const view2 = this.get(objectName, viewName, type);
     if (!view2) {
       const available = this.getByObjectName(objectName);
-      const availableNames = available.map((v) => v.name).join(", ") || "(none)";
+      const availableNames = available.map((v) => `${v.name} (${v.type})`).join(", ") || "(none)";
       throw new Error(
         `[ViewRegistry] View "${viewName}" not found for object "${objectName}".
 Available views: ${availableNames}`
@@ -613,8 +1145,12 @@ Available views: ${availableNames}`
   /**
    * Check if a view exists
    */
-  has(objectName, viewName) {
-    return this.views.has(this.makeKey(objectName, viewName));
+  has(objectName, viewName, type) {
+    if (type) {
+      return this.views.has(this.makeKey(objectName, viewName, type));
+    }
+    const objectViews = this.getByObjectName(objectName);
+    return objectViews.some((v) => v.name === viewName);
   }
   /**
    * Check if any views exist for an object
@@ -635,10 +1171,10 @@ Available views: ${availableNames}`
     return Array.from(this.byObject.keys());
   }
   /**
-   * Get default view for an object (if any)
+   * Get default view for an object and type
    */
-  getDefault(objectName) {
-    const views = this.getByObjectName(objectName);
+  getDefault(objectName, type) {
+    const views = this.getByObjectNameAndType(objectName, type);
     return views.find((v) => v.default) ?? views[0];
   }
   /**
@@ -647,20 +1183,21 @@ Available views: ${availableNames}`
   clear() {
     this.views.clear();
     this.byObject.clear();
+    this.byObjectAndType.clear();
   }
   /**
    * Generate summary string for debugging
    */
   summary() {
     const lines = [];
-    lines.push(`[ViewRegistry] ${this.size} native view(s) registered:`);
+    lines.push(`[ViewRegistry] ${this.size} view(s) registered:`);
     for (const objectName of this.listObjectNames()) {
       const views = this.getByObjectName(objectName);
       const viewNames = views.map((v) => {
         const flags = [];
         if (v.default) flags.push("default");
         const flagStr = flags.length > 0 ? ` (${flags.join(", ")})` : "";
-        return `${v.name}${flagStr}`;
+        return `${v.name}:${v.type}${flagStr}`;
       });
       lines.push(`  ${objectName}: ${viewNames.join(", ")}`);
     }
@@ -672,11 +1209,289 @@ Available views: ${availableNames}`
   debug() {
     console.info(this.summary());
   }
-  makeKey(objectName, viewName) {
-    return `${objectName}:${viewName}`;
+  makeKey(objectName, viewName, type) {
+    return `${objectName}:${viewName}:${type}`;
   }
 };
 var viewRegistry = new ViewRegistry();
+
+// src/views/auto-generator.ts
+function getVisibleAttributes(attributes, excludeNames = []) {
+  return attributes.filter(
+    (attr) => !(attr.hidden || attr.archived || attr.system || excludeNames.includes(attr.name))
+  );
+}
+function sortAttributes(attributes) {
+  return [...attributes].sort((a, b) => {
+    const orderA = a.order ?? 999;
+    const orderB = b.order ?? 999;
+    if (orderA !== orderB) return orderA - orderB;
+    return a.name.localeCompare(b.name);
+  });
+}
+function getDefaultFieldSpan(type) {
+  switch (type) {
+    case "textarea":
+    case "richtext":
+    case "location":
+      return 12;
+    case "checkbox":
+      return 4;
+    default:
+      return 6;
+  }
+}
+function attributeToField(attr) {
+  return {
+    attribute: attr.name,
+    span: getDefaultFieldSpan(attr.type)
+  };
+}
+function generateDefaultDetailView(object2, options = {}) {
+  const {
+    includeActivityTab = true,
+    includeNotesTab = true,
+    includeDocumentsTab = true,
+    includeFlowsTab = false,
+    excludeAttributes = []
+  } = options;
+  const visibleAttrs = getVisibleAttributes(object2.attributes, excludeAttributes);
+  const sortedAttrs = sortAttributes(visibleAttrs);
+  const formTab = {
+    id: "form",
+    name: "form",
+    label: "Details",
+    type: "form",
+    groups: [
+      {
+        id: "general",
+        label: "General",
+        fields: sortedAttrs.map(attributeToField),
+        order: 0
+      }
+    ],
+    order: 0
+  };
+  const tabs = [formTab];
+  let tabOrder = 1;
+  const hasDocuments = object2.attributes.some((attr) => attr.type === "document");
+  if (includeDocumentsTab && hasDocuments) {
+    tabs.push({
+      id: "documents",
+      name: "documents",
+      label: "Documents",
+      type: "documents",
+      order: tabOrder++,
+      allowUpload: true,
+      allowRemove: true,
+      showProcessing: true
+    });
+  }
+  if (includeActivityTab) {
+    tabs.push({
+      id: "activity",
+      name: "activity",
+      label: "Activity",
+      type: "activity",
+      order: tabOrder++
+    });
+  }
+  if (includeNotesTab) {
+    tabs.push({
+      id: "notes",
+      name: "notes",
+      label: "Notes",
+      type: "notes",
+      order: tabOrder++,
+      allowCreate: true
+    });
+  }
+  if (includeFlowsTab) {
+    tabs.push({
+      id: "flows",
+      name: "flows",
+      label: "Workflows",
+      type: "flows",
+      order: tabOrder++,
+      allowStart: true,
+      allowCancel: true
+    });
+  }
+  const config = {
+    layout: "page",
+    tabs
+  };
+  return {
+    name: "default",
+    label: "Default View",
+    object: object2.name,
+    type: "detail",
+    config,
+    default: true
+  };
+}
+function generateDefaultListView(object2, options = {}) {
+  const { excludeAttributes = [], maxListColumns = 5 } = options;
+  const visibleAttrs = getVisibleAttributes(object2.attributes, excludeAttributes);
+  const sortedAttrs = sortAttributes(visibleAttrs);
+  const columns = sortedAttrs.slice(0, maxListColumns).map((attr) => attr.name);
+  const config = {
+    layout: "table",
+    columns
+  };
+  return {
+    name: "default",
+    label: "All Records",
+    object: object2.name,
+    type: "list",
+    config,
+    default: true
+  };
+}
+function generateFallbackView(object2, type, options = {}) {
+  switch (type) {
+    case "detail":
+      return generateDefaultDetailView(object2, options);
+    case "list":
+      return generateDefaultListView(object2, options);
+    default:
+      throw new Error(`Fallback generation not supported for view type: ${type}`);
+  }
+}
+
+// src/views/view-reset.ts
+function getPreservedDetailTabs(view2, options) {
+  const { preserveCustomTabs = true, preserveTableTabs = true } = options;
+  const preserved = [];
+  for (const tab of view2.config.tabs) {
+    if (preserveCustomTabs && tab.type === "custom") {
+      preserved.push(tab);
+    }
+    if (preserveTableTabs && tab.type === "table") {
+      preserved.push(tab);
+    }
+  }
+  return preserved;
+}
+function mergeDetailTabs(generatedTabs, preservedTabs) {
+  if (preservedTabs.length === 0) {
+    return generatedTabs;
+  }
+  const formTab = generatedTabs.find((t) => t.type === "form");
+  const otherTabs = generatedTabs.filter((t) => t.type !== "form");
+  const result = [];
+  if (formTab) {
+    result.push(formTab);
+  }
+  let order = 1;
+  for (const tab of preservedTabs) {
+    result.push({ ...tab, order: order++ });
+  }
+  for (const tab of otherTabs) {
+    result.push({ ...tab, order: order++ });
+  }
+  return result;
+}
+function resetDetailViewToDefault(view2, object2, options) {
+  const { preserveMetadata = true, ...generateOptions } = options;
+  const defaultView = generateDefaultDetailView(object2, generateOptions);
+  const preservedTabs = getPreservedDetailTabs(view2, options);
+  const mergedTabs = mergeDetailTabs(defaultView.config.tabs, preservedTabs);
+  const config = {
+    ...defaultView.config,
+    tabs: mergedTabs
+  };
+  const resetView = {
+    ...defaultView,
+    config
+  };
+  if (preserveMetadata) {
+    resetView.id = view2.id;
+    resetView.name = view2.name;
+    resetView.label = view2.label;
+    resetView.description = view2.description;
+    resetView.icon = view2.icon;
+  }
+  return resetView;
+}
+function resetListViewToDefault(view2, object2, options) {
+  const { preserveMetadata = true, ...generateOptions } = options;
+  const defaultView = generateDefaultListView(object2, generateOptions);
+  const resetView = {
+    ...defaultView
+  };
+  if (preserveMetadata) {
+    resetView.id = view2.id;
+    resetView.name = view2.name;
+    resetView.label = view2.label;
+    resetView.description = view2.description;
+    resetView.icon = view2.icon;
+  }
+  return resetView;
+}
+function resetViewToDefault(currentView, object2, options = {}) {
+  if (isDetailView(currentView)) {
+    return resetDetailViewToDefault(currentView, object2, options);
+  }
+  if (isListView(currentView)) {
+    return resetListViewToDefault(currentView, object2, options);
+  }
+  throw new Error(`Reset not supported for view type: ${currentView.type}`);
+}
+function isDetailViewCustomized(view2, object2) {
+  const defaultView = generateDefaultDetailView(object2);
+  const viewFormTab = view2.config.tabs.find((t) => t.type === "form");
+  const defaultFormTab = defaultView.config.tabs.find((t) => t.type === "form");
+  if (!(viewFormTab && defaultFormTab)) {
+    return true;
+  }
+  if (viewFormTab.type !== "form" || defaultFormTab.type !== "form") {
+    return true;
+  }
+  if (viewFormTab.groups.length !== defaultFormTab.groups.length) {
+    return true;
+  }
+  for (let i = 0; i < viewFormTab.groups.length; i++) {
+    const viewGroup = viewFormTab.groups[i];
+    const defaultGroup = defaultFormTab.groups[i];
+    if (viewGroup.id !== defaultGroup.id) {
+      return true;
+    }
+    if (viewGroup.fields.length !== defaultGroup.fields.length) {
+      return true;
+    }
+    for (let j = 0; j < viewGroup.fields.length; j++) {
+      if (viewGroup.fields[j].attribute !== defaultGroup.fields[j].attribute) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
+function isListViewCustomized(view2, object2) {
+  const defaultView = generateDefaultListView(object2);
+  if (view2.config.columns.length !== defaultView.config.columns.length) {
+    return true;
+  }
+  for (let i = 0; i < view2.config.columns.length; i++) {
+    if (view2.config.columns[i] !== defaultView.config.columns[i]) {
+      return true;
+    }
+  }
+  if (view2.config.layout !== defaultView.config.layout) {
+    return true;
+  }
+  return false;
+}
+function isViewCustomized(view2, object2) {
+  if (isDetailView(view2)) {
+    return isDetailViewCustomized(view2, object2);
+  }
+  if (isListView(view2)) {
+    return isListViewCustomized(view2, object2);
+  }
+  return true;
+}
 export {
   ALL_SYSTEM_RESOURCES,
   ActivityTabConfig,
@@ -684,6 +1499,7 @@ export {
   AttributeNotFoundError,
   AuditService,
   AuthMethodSchema,
+  BEHAVIOR_PROPERTIES,
   BaseRepository,
   BaseService,
   ConcurrentModificationError,
@@ -702,6 +1518,7 @@ export {
   DEFAULT_THEME,
   DEFAULT_VALIDATION_MESSAGES,
   DRIVING_LICENSE,
+  DetailViewBuilder,
   DirectTableTabConfig,
   DocumentExecutor,
   DocumentGenerationNotConfiguredError,
@@ -721,8 +1538,11 @@ export {
   EndNodeSchema,
   ExecutorRegistry,
   FRENCH_ID_CARD,
+  FeatureFlagsContextError,
   FileNotFoundError,
   FileService,
+  FlagRegistry,
+  FlagService,
   FlowRowFieldSchema,
   FlowRowSchema,
   FlowsTabConfig,
@@ -738,12 +1558,15 @@ export {
   GrantNotFoundError,
   GrantRevokedError,
   GroupBuilder,
+  IDENTITY_PROPERTIES,
   InvalidPathError,
   InverseTableTabConfig,
   InvitationAlreadyAcceptedError,
   InvitationExpiredError,
   InvitationNotFoundError,
   InvitationRevokedError,
+  ListViewBuilder,
+  ListViewTabConfigBuilder,
   MaxDepthExceededError,
   NOTES,
   NO_VALUE_OPERATORS,
@@ -760,6 +1583,7 @@ export {
   ObjectReferencedError,
   ObjectSchemaService,
   PASSPORT,
+  PRESENTATION_PROPERTIES,
   PROOF_OF_ADDRESS,
   PermissionService,
   PolicyRegistry,
@@ -836,6 +1660,7 @@ export {
   asTenantId,
   asUserId,
   attributeConfigSchemas,
+  booleanFlag,
   buildAuditChanges,
   buildPolicyContext,
   cacheKeys,
@@ -866,6 +1691,8 @@ export {
   createDraftValidator,
   createEmptyContext,
   createFileValidator,
+  createFlagRegistry,
+  createFlagService,
   createFormAttributeValidator,
   createFormulaValidator,
   createLocationValidator,
@@ -893,6 +1720,7 @@ export {
   dateConfigSchema,
   defaultPolicyRegistry,
   defaultTtl,
+  detailView,
   document,
   documentConfigSchema,
   enrichRecordsWithFormulas,
@@ -916,14 +1744,19 @@ export {
   extractRelationReferences,
   file,
   fileConfigSchema,
+  flagRegistry,
   flattenRelationsForEval,
   formatAttributeValue,
   formatFormulaResult,
   formatRecord,
   formatRecords,
+  formatZodErrors,
   formula,
   formulaConfigSchema,
   generateCssVariables,
+  generateDefaultDetailView,
+  generateDefaultListView,
+  generateFallbackView,
   generateId,
   generatePrefixedId,
   generateTemplateName,
@@ -931,6 +1764,8 @@ export {
   getContext,
   getContextValue,
   getDefaultExecutorRegistry,
+  getFeatureFlags,
+  getFeatureValue,
   getMissingRequiredAttributes,
   getNodeOutputs,
   getPathDepth,
@@ -945,37 +1780,44 @@ export {
   getTargetAttributeName,
   getTenantId,
   getUserId,
+  getViewSeedPreview,
   getViewSyncPreview,
   group,
   hasContext,
+  hasFeatureFlagsContext,
+  hasProperties,
   hasRelationReferences,
   hasSchemaContext,
   hashOptions,
   inValues,
+  indexBy,
   isActivityTab,
-  isAdvancedFilterState,
   isAdvancedFormNode,
-  isConcurrentModificationError,
+  isBehaviorProperty,
+  isCalendarView,
   isConditionGroup,
   isConditionNode,
   isConditionRule,
   isCustomTab,
   isDefaultRole,
+  isDetailView,
   isDirectTableTab,
   isDocumentNode,
   isDocumentsTab,
-  isDocxTemplateSource,
   isEmpty,
   isEndNode,
+  isFeatureEnabled,
   isFlowDefinition,
   isFlowPublished,
   isFlowsTab,
   isForbiddenError,
   isFormNode,
   isFormTab,
+  isGalleryView,
   isGrantExpired,
   isGrantRevoked,
   isGrantValid,
+  isIdentityProperty,
   isInstanceEvent,
   isInstanceTerminal,
   isInstanceWaiting,
@@ -985,12 +1827,13 @@ export {
   isInvitationOrGrantEvent,
   isInvitationValid,
   isLabelExpression,
+  isListView,
   isNoValueOperator,
   isNodeEvent,
   isNotEmpty,
   isNotFoundError,
   isNotesTab,
-  isPdfTemplateSource,
+  isPresentationProperty,
   isProtectedResourceError,
   isRecordComplete,
   isSchemaError,
@@ -1002,14 +1845,17 @@ export {
   isSystemTemplate,
   isSystemWorkflow,
   isTableTab,
+  isTimelineView,
   isTokenRevoked,
   isUniversalRelation,
   isValidationError,
+  isViewCustomized,
   isWorkflowDefinition,
   isWorkflowPublished,
+  jsonFlag,
+  listView,
   location,
   locationConfigSchema,
-  mergeFormToSlot,
   mergeWithDefaults,
   multiselect,
   multiselectConfigSchema,
@@ -1017,6 +1863,7 @@ export {
   notesPolicy,
   number,
   numberConfigSchema,
+  numberFlag,
   object,
   or,
   parseAttributeConfig,
@@ -1031,6 +1878,7 @@ export {
   relation,
   relationConfigSchema,
   renderLabelExpression,
+  resetViewToDefault,
   resolveMultiplePaths,
   resolveSingleValue,
   richtext,
@@ -1038,15 +1886,18 @@ export {
   rollup,
   rollupConfigSchema,
   runWithContext,
+  runWithFeatureFlags,
   runWithMergedSchemaContext,
   runWithSchemaContext,
   safeParseAttributeConfig,
+  seedRegistryViews,
   select,
   selectConfigSchema,
   setContextValue,
   slugify,
   status,
   statusConfigSchema,
+  stringFlag,
   success,
   syncAll,
   syncNativeObjects,
@@ -1055,9 +1906,9 @@ export {
   textConfigSchema,
   textarea,
   textareaConfigSchema,
-  toAdvancedFilterState,
-  toSimpleFilterState,
+  toUndefinedIfEmpty,
   traversePath,
+  tryGetFeatureValue,
   user,
   userConfigSchema,
   validateAttribute,
@@ -1070,9 +1921,11 @@ export {
   validatePath,
   verifyNativeObjectsSync,
   verifyNativeViewsSync,
+  verifyRegistryViewsSeeded,
   view,
   viewRegistry,
   wait,
+  withFeatureFlags,
   withTenantContext,
   workflow
 };