@demokit-ai/core 0.3.0 → 0.5.0

package/dist/index.d.cts

@@ -81,6 +81,43 @@ interface SessionState {
  */
 declare function createSessionState(): SessionState;
 
+/**
+ * Configuration for automatic demo mode detection based on URL
+ */
+interface DetectionConfig {
+    /**
+     * Hostnames that should auto-enable demo mode
+     * @example ['demo.myapp.com', 'demo.localhost']
+     */
+    subdomains?: string[];
+    /**
+     * Query parameters that trigger demo mode when present
+     * @default ['demo']
+     * @example With ['demo'], visiting ?demo=true enables demo mode
+     */
+    queryParams?: string[];
+}
+/**
+ * Context passed to the onMutationIntercepted callback
+ */
+interface MutationInterceptedContext {
+    /**
+     * The full URL of the intercepted request
+     */
+    url: string;
+    /**
+     * HTTP method (POST, PUT, PATCH, DELETE)
+     */
+    method: string;
+    /**
+     * URL parameters extracted from the pattern
+     */
+    params: Record<string, string>;
+    /**
+     * The fixture pattern that matched
+     */
+    pattern: string;
+}
 /**
  * Configuration for creating a demo interceptor
  */
@@ -120,6 +157,44 @@ interface DemoKitConfig {
      * @default 'http://localhost'
      */
     baseUrl?: string;
+    /**
+     * Auto-detection configuration for enabling demo mode based on URL
+     * When configured, demo mode is automatically enabled on matching subdomains
+     * or when specific query parameters are present
+     */
+    detection?: DetectionConfig;
+    /**
+     * Path aliases for matching fixtures across equivalent URL prefixes.
+     * Common in Next.js apps where `/api/*` rewrites to `/v1/*`.
+     * A fixture defined for `/v1/users` will also match `/api/users`.
+     *
+     * @example
+     * pathAliases: { '/api/': '/v1/' }
+     */
+    pathAliases?: Record<string, string>;
+    /**
+     * Log a warning when a catch-all pattern (containing `*`) matches a request.
+     * Helps identify fixtures that need specific patterns.
+     * @default true in development, false in production
+     */
+    warnOnCatchAll?: boolean;
+    /**
+     * Guard callback that controls whether demo mode can be disabled.
+     * Return `true` to allow disabling, `false` to prevent it,
+     * or a string to prevent it and provide a reason message.
+     *
+     * @example
+     * canDisable: () => {
+     *   if (isPublicDemo) return 'Sign up to access your own data'
+     *   return true
+     * }
+     */
+    canDisable?: () => boolean | string;
+    /**
+     * Callback fired when a non-GET request is intercepted by a fixture.
+     * Useful for showing "simulated in demo mode" toast notifications.
+     */
+    onMutationIntercepted?: (context: MutationInterceptedContext) => void;
 }
 /**
  * Map of URL patterns to fixture handlers
@@ -194,13 +269,19 @@ interface DemoInterceptor {
      */
     enable(): void;
     /**
-     * Disable demo mode - fetches will pass through to the real API
+     * Disable demo mode - fetches will pass through to the real API.
+     * Returns `true` if disabled successfully, `false` or a string reason
+     * if prevented by the `canDisable` guard.
      */
-    disable(): void;
+    disable(): boolean | string;
     /**
      * Check if demo mode is currently enabled
      */
     isEnabled(): boolean;
+    /**
+     * Check if this is a public demo (auto-detected via subdomain)
+     */
+    isPublicDemo(): boolean;
     /**
      * Toggle demo mode state and return the new state
      */
@@ -273,8 +354,14 @@ interface RemoteConfig {
      */
     apiKey: string;
     /**
-     * DemoKit Cloud API URL
-     * @default 'https://api.demokit.cloud'
+     * DemoKit Cloud API URL (base URL)
+     * The SDK will append `/fixtures` to this URL.
+     * @example 'https://demokit-cloud.kasava.dev/api'
+     * @default 'https://api.demokit.cloud/api'
+     */
+    apiUrl?: string;
+    /**
+     * @deprecated Use apiUrl instead. This is kept for backwards compatibility.
      */
     cloudUrl?: string;
     /**
@@ -711,7 +798,11 @@ declare function clearDemoState(key?: string): void;
 /**
  * Default DemoKit Cloud API URL
  */
-declare const DEFAULT_CLOUD_URL = "https://api.demokit.cloud";
+declare const DEFAULT_API_URL = "https://api.demokit.cloud/api";
+/**
+ * @deprecated Use DEFAULT_API_URL instead
+ */
+declare const DEFAULT_CLOUD_URL = "https://api.demokit.cloud/api";
 /**
  * Default request timeout in milliseconds
  */
@@ -2875,4 +2966,4 @@ declare namespace checks {
   export { checks_equals as equals, checks_getTypeName as getTypeName, checks_hasArrayMaxLength as hasArrayMaxLength, checks_hasArrayMinLength as hasArrayMinLength, checks_hasMaxLength as hasMaxLength, checks_hasMaximum as hasMaximum, checks_hasMinLength as hasMinLength, checks_hasMinimum as hasMinimum, checks_isAfterOrEqual as isAfterOrEqual, checks_isArray as isArray, checks_isArrayNotEmpty as isArrayNotEmpty, checks_isBeforeOrEqual as isBeforeOrEqual, checks_isBoolean as isBoolean, checks_isDate as isDate, checks_isDateTime as isDateTime, checks_isEmail as isEmail, checks_isEmptyString as isEmptyString, checks_isISO8601 as isISO8601, checks_isInEnum as isInEnum, checks_isInteger as isInteger, checks_isNull as isNull, checks_isNullish as isNullish, checks_isNumber as isNumber, checks_isObject as isObject, checks_isString as isString, checks_isURL as isURL, checks_isUUID as isUUID, checks_isUndefined as isUndefined, checks_matchesPattern as matchesPattern };
 }
 
-export { type AppContext, type BooleanFieldRule, type Character, type CloudFixtureResponse, type CodebaseFile, DEFAULT_CLOUD_URL, DEFAULT_MAX_RETRIES, DEFAULT_STORAGE_KEY, DEFAULT_TIMEOUT, type DataModel, type Dataset, type DatasetFieldRule, type DemoData, type DemoInterceptor, type DemoKitConfig, type DemoKitRemoteConfig, type DemoNarrative, type DemoState, type DemoStateStore, type DemoStateStoreOptions, type DemokitSchema, type Endpoint, type EndpointMapping, type EntityContext, type EnumFieldRule, FORMAT_PATTERNS, FORMAT_PRIORITY, type FieldRule, FileParseError, type FixtureHandler, type FixtureMap, FormatDetectionError, type FormatDetectionPatterns, type FormatDetectionResult, type GenerationLevel, type GenerationMetadata, type GenerationOptions, type GenerationResult, type GenerationRulesConfig, type HttpMethod, type IntegerFieldRule, type MatchResult, type MergeConflict, type MergeOptions, type MergeResult, type MetricTarget, type ModelData, type ModelSourceMap, type ModelType, type NumberFieldRule, type OutputOptions, type ParameterDef, type ParseCSVResult, type ParseOptions, type ParseResult, type ParseSchemaOptions, type ParseWarning, type ParsedPattern, type PropertyDef, type PropertyDiff, type PropertyType, type QueryKey, type QueryKeyElement, type QueryKeyMatchResult, type Relationship, type RelationshipDetectionMethod, type RelationshipSide, type RelationshipTarget, type RelationshipType, type RemoteConfig, RemoteFetchError, type RemoteLoadingState, type RequestBody, type RequestContext, type ResponseDef, type RuleGeneratorConfig, type SafeResult, type SchemaDiff, type SchemaDiffItem, type SchemaFormat, type SchemaInfo, SchemaMergeError, SchemaParseError, type SchemaRef, type SchemaSource, SchemaValidationError, type SessionState, type StringFieldRule, type TimelineEvent, type ValidationCheck, type ValidationError, type ValidationErrorType, type ValidationResult, type ValidationRule, type ValidationStats, type ValidationWarning, type ValidationWarningType, type ValidatorOptions, aggregateWarnings, buildFixtureMap, checks, clearDemoState, clearPatternCache, createAppContext, createDemoInterceptor, createDemoState, createDemoStateStore, createHandlerForMapping, createRemoteFixtures, createSessionState, describeRule, detectFormat, detectFormatFromFiles, detectRelationshipFromExtension, detectRelationshipFromNaming, detectRelationshipFromRef, detectRelationships, diffSchemas, errorToWarning, extractRefName, fetchCloudFixtures, findMatchingPattern, findMatchingQueryKeyPattern, formatAsCSV, formatAsJSON, formatAsSQL, formatAsTypeScript, generateCuid, generateDatasetId, generateDemoData, generateId, generateIdForModel, generatePrefixedId, generateRulesFromSchema, generateSeededUUID, generateUUID, generateUlid, generateValue, getModelDependencyOrder, getRelationshipRules, getRelationshipsForModel, getRequiredFieldRules, groupFilesByFormat, groupRulesByModel, inferAppContext, isModelReferenced, isRecoverableError, isSchemaRef, isValidApiKey, loadDemoState, matchQueryKey, matchUrl, mergeAppContext, mergeFixtures, mergeSchemas, parseCSV, parseDrizzle, parseGraphQL, parseNextJS, parseOpenAPIFromObject, parseOpenAPIFromPath, parseOpenAPIFromString, parsePrisma, parseSchema, parseSchemaMultiFormat, parseSupabase, parseTRPC, parseTypeScript, parseUrlPattern, parseZod, safeExecute, safeProcessMany, saveDemoState, validateData, validateDatasetName, validateTimestampOrder };
+export { type AppContext, type BooleanFieldRule, type Character, type CloudFixtureResponse, type CodebaseFile, DEFAULT_API_URL, DEFAULT_CLOUD_URL, DEFAULT_MAX_RETRIES, DEFAULT_STORAGE_KEY, DEFAULT_TIMEOUT, type DataModel, type Dataset, type DatasetFieldRule, type DemoData, type DemoInterceptor, type DemoKitConfig, type DemoKitRemoteConfig, type DemoNarrative, type DemoState, type DemoStateStore, type DemoStateStoreOptions, type DemokitSchema, type DetectionConfig, type Endpoint, type EndpointMapping, type EntityContext, type EnumFieldRule, FORMAT_PATTERNS, FORMAT_PRIORITY, type FieldRule, FileParseError, type FixtureHandler, type FixtureMap, FormatDetectionError, type FormatDetectionPatterns, type FormatDetectionResult, type GenerationLevel, type GenerationMetadata, type GenerationOptions, type GenerationResult, type GenerationRulesConfig, type HttpMethod, type IntegerFieldRule, type MatchResult, type MergeConflict, type MergeOptions, type MergeResult, type MetricTarget, type ModelData, type ModelSourceMap, type ModelType, type MutationInterceptedContext, type NumberFieldRule, type OutputOptions, type ParameterDef, type ParseCSVResult, type ParseOptions, type ParseResult, type ParseSchemaOptions, type ParseWarning, type ParsedPattern, type PropertyDef, type PropertyDiff, type PropertyType, type QueryKey, type QueryKeyElement, type QueryKeyMatchResult, type Relationship, type RelationshipDetectionMethod, type RelationshipSide, type RelationshipTarget, type RelationshipType, type RemoteConfig, RemoteFetchError, type RemoteLoadingState, type RequestBody, type RequestContext, type ResponseDef, type RuleGeneratorConfig, type SafeResult, type SchemaDiff, type SchemaDiffItem, type SchemaFormat, type SchemaInfo, SchemaMergeError, SchemaParseError, type SchemaRef, type SchemaSource, SchemaValidationError, type SessionState, type StringFieldRule, type TimelineEvent, type ValidationCheck, type ValidationError, type ValidationErrorType, type ValidationResult, type ValidationRule, type ValidationStats, type ValidationWarning, type ValidationWarningType, type ValidatorOptions, aggregateWarnings, buildFixtureMap, checks, clearDemoState, clearPatternCache, createAppContext, createDemoInterceptor, createDemoState, createDemoStateStore, createHandlerForMapping, createRemoteFixtures, createSessionState, describeRule, detectFormat, detectFormatFromFiles, detectRelationshipFromExtension, detectRelationshipFromNaming, detectRelationshipFromRef, detectRelationships, diffSchemas, errorToWarning, extractRefName, fetchCloudFixtures, findMatchingPattern, findMatchingQueryKeyPattern, formatAsCSV, formatAsJSON, formatAsSQL, formatAsTypeScript, generateCuid, generateDatasetId, generateDemoData, generateId, generateIdForModel, generatePrefixedId, generateRulesFromSchema, generateSeededUUID, generateUUID, generateUlid, generateValue, getModelDependencyOrder, getRelationshipRules, getRelationshipsForModel, getRequiredFieldRules, groupFilesByFormat, groupRulesByModel, inferAppContext, isModelReferenced, isRecoverableError, isSchemaRef, isValidApiKey, loadDemoState, matchQueryKey, matchUrl, mergeAppContext, mergeFixtures, mergeSchemas, parseCSV, parseDrizzle, parseGraphQL, parseNextJS, parseOpenAPIFromObject, parseOpenAPIFromPath, parseOpenAPIFromString, parsePrisma, parseSchema, parseSchemaMultiFormat, parseSupabase, parseTRPC, parseTypeScript, parseUrlPattern, parseZod, safeExecute, safeProcessMany, saveDemoState, validateData, validateDatasetName, validateTimestampOrder };

package/dist/index.d.ts

@@ -81,6 +81,43 @@ interface SessionState {
  */
 declare function createSessionState(): SessionState;
 
+/**
+ * Configuration for automatic demo mode detection based on URL
+ */
+interface DetectionConfig {
+    /**
+     * Hostnames that should auto-enable demo mode
+     * @example ['demo.myapp.com', 'demo.localhost']
+     */
+    subdomains?: string[];
+    /**
+     * Query parameters that trigger demo mode when present
+     * @default ['demo']
+     * @example With ['demo'], visiting ?demo=true enables demo mode
+     */
+    queryParams?: string[];
+}
+/**
+ * Context passed to the onMutationIntercepted callback
+ */
+interface MutationInterceptedContext {
+    /**
+     * The full URL of the intercepted request
+     */
+    url: string;
+    /**
+     * HTTP method (POST, PUT, PATCH, DELETE)
+     */
+    method: string;
+    /**
+     * URL parameters extracted from the pattern
+     */
+    params: Record<string, string>;
+    /**
+     * The fixture pattern that matched
+     */
+    pattern: string;
+}
 /**
  * Configuration for creating a demo interceptor
  */
@@ -120,6 +157,44 @@ interface DemoKitConfig {
      * @default 'http://localhost'
      */
     baseUrl?: string;
+    /**
+     * Auto-detection configuration for enabling demo mode based on URL
+     * When configured, demo mode is automatically enabled on matching subdomains
+     * or when specific query parameters are present
+     */
+    detection?: DetectionConfig;
+    /**
+     * Path aliases for matching fixtures across equivalent URL prefixes.
+     * Common in Next.js apps where `/api/*` rewrites to `/v1/*`.
+     * A fixture defined for `/v1/users` will also match `/api/users`.
+     *
+     * @example
+     * pathAliases: { '/api/': '/v1/' }
+     */
+    pathAliases?: Record<string, string>;
+    /**
+     * Log a warning when a catch-all pattern (containing `*`) matches a request.
+     * Helps identify fixtures that need specific patterns.
+     * @default true in development, false in production
+     */
+    warnOnCatchAll?: boolean;
+    /**
+     * Guard callback that controls whether demo mode can be disabled.
+     * Return `true` to allow disabling, `false` to prevent it,
+     * or a string to prevent it and provide a reason message.
+     *
+     * @example
+     * canDisable: () => {
+     *   if (isPublicDemo) return 'Sign up to access your own data'
+     *   return true
+     * }
+     */
+    canDisable?: () => boolean | string;
+    /**
+     * Callback fired when a non-GET request is intercepted by a fixture.
+     * Useful for showing "simulated in demo mode" toast notifications.
+     */
+    onMutationIntercepted?: (context: MutationInterceptedContext) => void;
 }
 /**
  * Map of URL patterns to fixture handlers
@@ -194,13 +269,19 @@ interface DemoInterceptor {
      */
     enable(): void;
     /**
-     * Disable demo mode - fetches will pass through to the real API
+     * Disable demo mode - fetches will pass through to the real API.
+     * Returns `true` if disabled successfully, `false` or a string reason
+     * if prevented by the `canDisable` guard.
      */
-    disable(): void;
+    disable(): boolean | string;
     /**
      * Check if demo mode is currently enabled
      */
     isEnabled(): boolean;
+    /**
+     * Check if this is a public demo (auto-detected via subdomain)
+     */
+    isPublicDemo(): boolean;
     /**
      * Toggle demo mode state and return the new state
      */
@@ -273,8 +354,14 @@ interface RemoteConfig {
      */
     apiKey: string;
     /**
-     * DemoKit Cloud API URL
-     * @default 'https://api.demokit.cloud'
+     * DemoKit Cloud API URL (base URL)
+     * The SDK will append `/fixtures` to this URL.
+     * @example 'https://demokit-cloud.kasava.dev/api'
+     * @default 'https://api.demokit.cloud/api'
+     */
+    apiUrl?: string;
+    /**
+     * @deprecated Use apiUrl instead. This is kept for backwards compatibility.
      */
     cloudUrl?: string;
     /**
@@ -711,7 +798,11 @@ declare function clearDemoState(key?: string): void;
 /**
  * Default DemoKit Cloud API URL
  */
-declare const DEFAULT_CLOUD_URL = "https://api.demokit.cloud";
+declare const DEFAULT_API_URL = "https://api.demokit.cloud/api";
+/**
+ * @deprecated Use DEFAULT_API_URL instead
+ */
+declare const DEFAULT_CLOUD_URL = "https://api.demokit.cloud/api";
 /**
  * Default request timeout in milliseconds
  */
@@ -2875,4 +2966,4 @@ declare namespace checks {
   export { checks_equals as equals, checks_getTypeName as getTypeName, checks_hasArrayMaxLength as hasArrayMaxLength, checks_hasArrayMinLength as hasArrayMinLength, checks_hasMaxLength as hasMaxLength, checks_hasMaximum as hasMaximum, checks_hasMinLength as hasMinLength, checks_hasMinimum as hasMinimum, checks_isAfterOrEqual as isAfterOrEqual, checks_isArray as isArray, checks_isArrayNotEmpty as isArrayNotEmpty, checks_isBeforeOrEqual as isBeforeOrEqual, checks_isBoolean as isBoolean, checks_isDate as isDate, checks_isDateTime as isDateTime, checks_isEmail as isEmail, checks_isEmptyString as isEmptyString, checks_isISO8601 as isISO8601, checks_isInEnum as isInEnum, checks_isInteger as isInteger, checks_isNull as isNull, checks_isNullish as isNullish, checks_isNumber as isNumber, checks_isObject as isObject, checks_isString as isString, checks_isURL as isURL, checks_isUUID as isUUID, checks_isUndefined as isUndefined, checks_matchesPattern as matchesPattern };
 }
 
-export { type AppContext, type BooleanFieldRule, type Character, type CloudFixtureResponse, type CodebaseFile, DEFAULT_CLOUD_URL, DEFAULT_MAX_RETRIES, DEFAULT_STORAGE_KEY, DEFAULT_TIMEOUT, type DataModel, type Dataset, type DatasetFieldRule, type DemoData, type DemoInterceptor, type DemoKitConfig, type DemoKitRemoteConfig, type DemoNarrative, type DemoState, type DemoStateStore, type DemoStateStoreOptions, type DemokitSchema, type Endpoint, type EndpointMapping, type EntityContext, type EnumFieldRule, FORMAT_PATTERNS, FORMAT_PRIORITY, type FieldRule, FileParseError, type FixtureHandler, type FixtureMap, FormatDetectionError, type FormatDetectionPatterns, type FormatDetectionResult, type GenerationLevel, type GenerationMetadata, type GenerationOptions, type GenerationResult, type GenerationRulesConfig, type HttpMethod, type IntegerFieldRule, type MatchResult, type MergeConflict, type MergeOptions, type MergeResult, type MetricTarget, type ModelData, type ModelSourceMap, type ModelType, type NumberFieldRule, type OutputOptions, type ParameterDef, type ParseCSVResult, type ParseOptions, type ParseResult, type ParseSchemaOptions, type ParseWarning, type ParsedPattern, type PropertyDef, type PropertyDiff, type PropertyType, type QueryKey, type QueryKeyElement, type QueryKeyMatchResult, type Relationship, type RelationshipDetectionMethod, type RelationshipSide, type RelationshipTarget, type RelationshipType, type RemoteConfig, RemoteFetchError, type RemoteLoadingState, type RequestBody, type RequestContext, type ResponseDef, type RuleGeneratorConfig, type SafeResult, type SchemaDiff, type SchemaDiffItem, type SchemaFormat, type SchemaInfo, SchemaMergeError, SchemaParseError, type SchemaRef, type SchemaSource, SchemaValidationError, type SessionState, type StringFieldRule, type TimelineEvent, type ValidationCheck, type ValidationError, type ValidationErrorType, type ValidationResult, type ValidationRule, type ValidationStats, type ValidationWarning, type ValidationWarningType, type ValidatorOptions, aggregateWarnings, buildFixtureMap, checks, clearDemoState, clearPatternCache, createAppContext, createDemoInterceptor, createDemoState, createDemoStateStore, createHandlerForMapping, createRemoteFixtures, createSessionState, describeRule, detectFormat, detectFormatFromFiles, detectRelationshipFromExtension, detectRelationshipFromNaming, detectRelationshipFromRef, detectRelationships, diffSchemas, errorToWarning, extractRefName, fetchCloudFixtures, findMatchingPattern, findMatchingQueryKeyPattern, formatAsCSV, formatAsJSON, formatAsSQL, formatAsTypeScript, generateCuid, generateDatasetId, generateDemoData, generateId, generateIdForModel, generatePrefixedId, generateRulesFromSchema, generateSeededUUID, generateUUID, generateUlid, generateValue, getModelDependencyOrder, getRelationshipRules, getRelationshipsForModel, getRequiredFieldRules, groupFilesByFormat, groupRulesByModel, inferAppContext, isModelReferenced, isRecoverableError, isSchemaRef, isValidApiKey, loadDemoState, matchQueryKey, matchUrl, mergeAppContext, mergeFixtures, mergeSchemas, parseCSV, parseDrizzle, parseGraphQL, parseNextJS, parseOpenAPIFromObject, parseOpenAPIFromPath, parseOpenAPIFromString, parsePrisma, parseSchema, parseSchemaMultiFormat, parseSupabase, parseTRPC, parseTypeScript, parseUrlPattern, parseZod, safeExecute, safeProcessMany, saveDemoState, validateData, validateDatasetName, validateTimestampOrder };
+export { type AppContext, type BooleanFieldRule, type Character, type CloudFixtureResponse, type CodebaseFile, DEFAULT_API_URL, DEFAULT_CLOUD_URL, DEFAULT_MAX_RETRIES, DEFAULT_STORAGE_KEY, DEFAULT_TIMEOUT, type DataModel, type Dataset, type DatasetFieldRule, type DemoData, type DemoInterceptor, type DemoKitConfig, type DemoKitRemoteConfig, type DemoNarrative, type DemoState, type DemoStateStore, type DemoStateStoreOptions, type DemokitSchema, type DetectionConfig, type Endpoint, type EndpointMapping, type EntityContext, type EnumFieldRule, FORMAT_PATTERNS, FORMAT_PRIORITY, type FieldRule, FileParseError, type FixtureHandler, type FixtureMap, FormatDetectionError, type FormatDetectionPatterns, type FormatDetectionResult, type GenerationLevel, type GenerationMetadata, type GenerationOptions, type GenerationResult, type GenerationRulesConfig, type HttpMethod, type IntegerFieldRule, type MatchResult, type MergeConflict, type MergeOptions, type MergeResult, type MetricTarget, type ModelData, type ModelSourceMap, type ModelType, type MutationInterceptedContext, type NumberFieldRule, type OutputOptions, type ParameterDef, type ParseCSVResult, type ParseOptions, type ParseResult, type ParseSchemaOptions, type ParseWarning, type ParsedPattern, type PropertyDef, type PropertyDiff, type PropertyType, type QueryKey, type QueryKeyElement, type QueryKeyMatchResult, type Relationship, type RelationshipDetectionMethod, type RelationshipSide, type RelationshipTarget, type RelationshipType, type RemoteConfig, RemoteFetchError, type RemoteLoadingState, type RequestBody, type RequestContext, type ResponseDef, type RuleGeneratorConfig, type SafeResult, type SchemaDiff, type SchemaDiffItem, type SchemaFormat, type SchemaInfo, SchemaMergeError, SchemaParseError, type SchemaRef, type SchemaSource, SchemaValidationError, type SessionState, type StringFieldRule, type TimelineEvent, type ValidationCheck, type ValidationError, type ValidationErrorType, type ValidationResult, type ValidationRule, type ValidationStats, type ValidationWarning, type ValidationWarningType, type ValidatorOptions, aggregateWarnings, buildFixtureMap, checks, clearDemoState, clearPatternCache, createAppContext, createDemoInterceptor, createDemoState, createDemoStateStore, createHandlerForMapping, createRemoteFixtures, createSessionState, describeRule, detectFormat, detectFormatFromFiles, detectRelationshipFromExtension, detectRelationshipFromNaming, detectRelationshipFromRef, detectRelationships, diffSchemas, errorToWarning, extractRefName, fetchCloudFixtures, findMatchingPattern, findMatchingQueryKeyPattern, formatAsCSV, formatAsJSON, formatAsSQL, formatAsTypeScript, generateCuid, generateDatasetId, generateDemoData, generateId, generateIdForModel, generatePrefixedId, generateRulesFromSchema, generateSeededUUID, generateUUID, generateUlid, generateValue, getModelDependencyOrder, getRelationshipRules, getRelationshipsForModel, getRequiredFieldRules, groupFilesByFormat, groupRulesByModel, inferAppContext, isModelReferenced, isRecoverableError, isSchemaRef, isValidApiKey, loadDemoState, matchQueryKey, matchUrl, mergeAppContext, mergeFixtures, mergeSchemas, parseCSV, parseDrizzle, parseGraphQL, parseNextJS, parseOpenAPIFromObject, parseOpenAPIFromPath, parseOpenAPIFromString, parsePrisma, parseSchema, parseSchemaMultiFormat, parseSupabase, parseTRPC, parseTypeScript, parseUrlPattern, parseZod, safeExecute, safeProcessMany, saveDemoState, validateData, validateDatasetName, validateTimestampOrder };

package/dist/index.js

@@ -330,6 +330,26 @@ function extractUrl(input, baseUrl) {
   }
   return baseUrl;
 }
+function detectDemoMode(detection) {
+  if (!detection || typeof window === "undefined") {
+    return { detected: false, isPublicDemo: false };
+  }
+  if (detection.subdomains?.length) {
+    const hostname = window.location.hostname;
+    if (detection.subdomains.some((sub) => hostname === sub)) {
+      return { detected: true, isPublicDemo: true };
+    }
+  }
+  const queryParams = detection.queryParams ?? ["demo"];
+  const searchParams = new URLSearchParams(window.location.search);
+  for (const param of queryParams) {
+    const value = searchParams.get(param);
+    if (value !== null && value !== "false") {
+      return { detected: true, isPublicDemo: false };
+    }
+  }
+  return { detected: false, isPublicDemo: false };
+}
 function createDemoInterceptor(config) {
   const {
     fixtures: initialFixtures,
@@ -337,9 +357,15 @@ function createDemoInterceptor(config) {
     onEnable,
     onDisable,
     initialEnabled,
-    baseUrl = "http://localhost"
+    baseUrl = "http://localhost",
+    detection,
+    canDisable,
+    onMutationIntercepted,
+    pathAliases,
+    warnOnCatchAll = typeof process !== "undefined" && process.env?.NODE_ENV !== "production"
   } = config;
-  let enabled = initialEnabled ?? loadDemoState(storageKey);
+  const detectionResult = detectDemoMode(detection);
+  let enabled = detectionResult.detected || (initialEnabled ?? loadDemoState(storageKey));
   let currentFixtures = { ...initialFixtures };
   let sessionState = createSessionState();
   let originalFetch = null;
@@ -355,11 +381,25 @@ function createDemoInterceptor(config) {
       }
       const method = init?.method?.toUpperCase() || "GET";
       const pathname = extractPathname(input, baseUrl);
-      const match = findMatchingPattern(currentFixtures, method, pathname);
+      let match = findMatchingPattern(currentFixtures, method, pathname);
+      if (!match && pathAliases) {
+        for (const [from, to] of Object.entries(pathAliases)) {
+          if (pathname.startsWith(from)) {
+            const aliasedPath = to + pathname.slice(from.length);
+            match = findMatchingPattern(currentFixtures, method, aliasedPath);
+            if (match) break;
+          }
+        }
+      }
       if (!match) {
         return originalFetch(input, init);
       }
       const [pattern, matchResult] = match;
+      if (warnOnCatchAll && pattern.includes("*")) {
+        console.warn(
+          `[DemoKit] Catch-all fixture matched: ${method} ${pathname} \u2192 "${pattern}". Consider adding a specific fixture.`
+        );
+      }
       const handler = currentFixtures[pattern];
       const url = extractUrl(input, baseUrl);
       const headers = new Headers(init?.headers);
@@ -379,6 +419,14 @@ function createDemoInterceptor(config) {
         headers,
         session: sessionState
       };
+      if (method !== "GET" && onMutationIntercepted) {
+        onMutationIntercepted({
+          url,
+          method,
+          params: matchResult.params,
+          pattern
+        });
+      }
       let result;
       try {
         if (typeof handler === "function") {
@@ -414,14 +462,24 @@ function createDemoInterceptor(config) {
       onEnable?.();
     },
     disable() {
-      if (!enabled) return;
+      if (!enabled) return true;
+      if (canDisable) {
+        const result = canDisable();
+        if (result !== true) {
+          return result;
+        }
+      }
       enabled = false;
       saveDemoState(storageKey, false);
       onDisable?.();
+      return true;
     },
     isEnabled() {
       return enabled;
     },
+    isPublicDemo() {
+      return detectionResult.isPublicDemo;
+    },
     toggle() {
       if (enabled) {
         this.disable();
@@ -524,7 +582,8 @@ function createDemoStateStore(options = {}) {
 }
 
 // src/remote.ts
-var DEFAULT_CLOUD_URL = "https://api.demokit.cloud";
+var DEFAULT_API_URL = "https://api.demokit.cloud/api";
+var DEFAULT_CLOUD_URL = DEFAULT_API_URL;
 var DEFAULT_TIMEOUT = 1e4;
 var DEFAULT_MAX_RETRIES = 3;
 function isValidApiKey(apiKey) {
@@ -547,13 +606,16 @@ function getBackoffDelay(attempt, baseDelay = 1e3) {
 async function fetchCloudFixtures(config) {
   const {
     apiKey,
-    cloudUrl = DEFAULT_CLOUD_URL,
+    apiUrl,
+    cloudUrl,
+    // deprecated, for backwards compatibility
     onError,
     onLoad,
     timeout = DEFAULT_TIMEOUT,
     retry = true,
     maxRetries = DEFAULT_MAX_RETRIES
   } = config;
+  const baseUrl = apiUrl || cloudUrl || DEFAULT_API_URL;
   if (!isValidApiKey(apiKey)) {
     const error = new RemoteFetchError(
       "Invalid API key format. Expected format: dk_live_xxx",
@@ -563,7 +625,7 @@ async function fetchCloudFixtures(config) {
     onError?.(error);
     throw error;
   }
-  const url = `${cloudUrl.replace(/\/$/, "")}/api/v1/fixtures`;
+  const url = `${baseUrl.replace(/\/$/, "")}/fixtures`;
   let lastError = null;
   const maxAttempts = retry ? maxRetries : 1;
   for (let attempt = 0; attempt < maxAttempts; attempt++) {
@@ -6847,6 +6909,6 @@ function getRequiredFieldRules(rules) {
   return rules.filter((rule) => rule.required);
 }
 
-export { DEFAULT_CLOUD_URL, DEFAULT_MAX_RETRIES, DEFAULT_STORAGE_KEY, DEFAULT_TIMEOUT, FORMAT_PATTERNS, FORMAT_PRIORITY, FileParseError, FormatDetectionError, RemoteFetchError, SchemaMergeError, SchemaParseError, SchemaValidationError, aggregateWarnings, buildFixtureMap, checks_exports as checks, clearDemoState, clearPatternCache, createAppContext, createDemoInterceptor, createDemoState, createDemoStateStore, createHandlerForMapping, createRemoteFixtures, createSessionState, describeRule, detectFormat, detectFormatFromFiles, detectRelationshipFromExtension, detectRelationshipFromNaming, detectRelationshipFromRef, detectRelationships, diffSchemas, errorToWarning, extractRefName, fetchCloudFixtures, findMatchingPattern, findMatchingQueryKeyPattern, formatAsCSV, formatAsJSON, formatAsSQL, formatAsTypeScript, generateCuid, generateDatasetId, generateDemoData, generateId, generateIdForModel, generatePrefixedId, generateRulesFromSchema, generateSeededUUID, generateUUID, generateUlid, generateValue, getModelDependencyOrder, getRelationshipRules, getRelationshipsForModel, getRequiredFieldRules, groupFilesByFormat, groupRulesByModel, inferAppContext, isModelReferenced, isRecoverableError, isSchemaRef, isValidApiKey, loadDemoState, matchQueryKey, matchUrl, mergeAppContext, mergeFixtures, mergeSchemas, parseCSV, parseDrizzle, parseGraphQL, parseNextJS, parseOpenAPIFromObject, parseOpenAPIFromPath, parseOpenAPIFromString, parsePrisma, parseSchema, parseSchemaMultiFormat, parseSupabase, parseTRPC, parseTypeScript, parseUrlPattern, parseZod, safeExecute, safeProcessMany, saveDemoState, validateData, validateDatasetName, validateTimestampOrder };
+export { DEFAULT_API_URL, DEFAULT_CLOUD_URL, DEFAULT_MAX_RETRIES, DEFAULT_STORAGE_KEY, DEFAULT_TIMEOUT, FORMAT_PATTERNS, FORMAT_PRIORITY, FileParseError, FormatDetectionError, RemoteFetchError, SchemaMergeError, SchemaParseError, SchemaValidationError, aggregateWarnings, buildFixtureMap, checks_exports as checks, clearDemoState, clearPatternCache, createAppContext, createDemoInterceptor, createDemoState, createDemoStateStore, createHandlerForMapping, createRemoteFixtures, createSessionState, describeRule, detectFormat, detectFormatFromFiles, detectRelationshipFromExtension, detectRelationshipFromNaming, detectRelationshipFromRef, detectRelationships, diffSchemas, errorToWarning, extractRefName, fetchCloudFixtures, findMatchingPattern, findMatchingQueryKeyPattern, formatAsCSV, formatAsJSON, formatAsSQL, formatAsTypeScript, generateCuid, generateDatasetId, generateDemoData, generateId, generateIdForModel, generatePrefixedId, generateRulesFromSchema, generateSeededUUID, generateUUID, generateUlid, generateValue, getModelDependencyOrder, getRelationshipRules, getRelationshipsForModel, getRequiredFieldRules, groupFilesByFormat, groupRulesByModel, inferAppContext, isModelReferenced, isRecoverableError, isSchemaRef, isValidApiKey, loadDemoState, matchQueryKey, matchUrl, mergeAppContext, mergeFixtures, mergeSchemas, parseCSV, parseDrizzle, parseGraphQL, parseNextJS, parseOpenAPIFromObject, parseOpenAPIFromPath, parseOpenAPIFromString, parsePrisma, parseSchema, parseSchemaMultiFormat, parseSupabase, parseTRPC, parseTypeScript, parseUrlPattern, parseZod, safeExecute, safeProcessMany, saveDemoState, validateData, validateDatasetName, validateTimestampOrder };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map