@objectstack/spec 3.0.3 → 3.0.5

package/dist/index.d.mts

@@ -5,7 +5,7 @@ export { i as Data } from './index-CTwYO4Y3.mjs';
 export { i as Security } from './index-BfEDC8Lv.mjs';
 export { i as UI, a as defineApp, d as defineView } from './index-B3_U_17f.mjs';
 export { i as System } from './index-DywIgfSF.mjs';
-export { i as Kernel, P as PluginContext } from './index-CQMwv2XR.mjs';
+export { i as Kernel, P as PluginContext } from './index-DqAoreZC.mjs';
 import { F as FilterGroup } from './index-CND4h8W_.mjs';
 export { i as AI, d as defineAgent } from './index-CND4h8W_.mjs';
 export { i as Automation, d as defineFlow } from './index-DwA_tFsR.mjs';
@@ -510,6 +510,117 @@ declare function safeParsePretty<T extends z.ZodTypeAny>(schema: T, data: unknow
     formatted: string;
 };
 
+/**
+ * Metadata Collection Utilities
+ *
+ * Provides support for defining metadata collections in either array or map (Record) format.
+ * Map format automatically injects the key as the `name` field, following the same pattern
+ * used by `fields` in ObjectSchema (which already uses `z.record(key, FieldSchema)`).
+ *
+ * ## Usage
+ *
+ * Both formats are accepted and normalized to arrays:
+ *
+ * ```ts
+ * // Array format (traditional)
+ * defineStack({
+ *   objects: [
+ *     { name: 'account', fields: { ... } },
+ *     { name: 'contact', fields: { ... } },
+ *   ]
+ * });
+ *
+ * // Map format (key becomes `name`)
+ * defineStack({
+ *   objects: {
+ *     account: { fields: { ... } },
+ *     contact: { fields: { ... } },
+ *   }
+ * });
+ * ```
+ *
+ * @module
+ */
+/**
+ * Input type for metadata collections: accepts either an array or a named map.
+ * When using map format, the key is injected as the `name` field of each item.
+ *
+ * @typeParam T - The metadata item type (e.g., `ObjectSchema`, `AppSchema`)
+ *
+ * @example
+ * ```ts
+ * // Array format — name is required in each item
+ * const apps: MetadataCollectionInput<App> = [
+ *   { name: 'sales', label: 'Sales' },
+ *   { name: 'service', label: 'Service' },
+ * ];
+ *
+ * // Map format — key serves as name, so name is optional in value
+ * const apps: MetadataCollectionInput<App> = {
+ *   sales: { label: 'Sales' },
+ *   service: { label: 'Service' },
+ * };
+ * ```
+ */
+type MetadataCollectionInput<T> = T[] | Record<string, Omit<T, 'name'> & {
+    name?: string;
+}>;
+/**
+ * List of metadata fields in ObjectStackDefinitionSchema that support map format.
+ * These are fields where each item has a `name` field that can be inferred from the map key.
+ *
+ * Excluded fields:
+ * - `views` — ViewSchema has no `name` field (it's a container with `list`/`form`)
+ * - `objectExtensions` — uses `extend` as its identifier, not `name`
+ * - `data` — DatasetSchema uses `object` as its identifier
+ * - `translations` — TranslationBundleSchema is a record, not a named object
+ * - `plugins` / `devPlugins` — not named metadata schemas
+ */
+declare const MAP_SUPPORTED_FIELDS: readonly ["objects", "apps", "pages", "dashboards", "reports", "actions", "themes", "workflows", "approvals", "flows", "roles", "permissions", "sharingRules", "policies", "apis", "webhooks", "agents", "ragPipelines", "hooks", "mappings", "analyticsCubes", "connectors", "datasources"];
+type MapSupportedField = (typeof MAP_SUPPORTED_FIELDS)[number];
+/**
+ * Normalize a single metadata collection value from map format to array format.
+ * If the input is already an array (or nullish), it is returned unchanged.
+ * If the input is a plain object (map), it is converted to an array where
+ * each key is injected as the `name` field of the corresponding item.
+ *
+ * **Precedence:** If an item already has a `name` property, it is preserved
+ * (the map key is only used as a fallback).
+ *
+ * @param value - The raw input value (array, map, or nullish)
+ * @param keyField - The field name to inject the key into (default: `'name'`)
+ * @returns The normalized array, or the original value if already an array/nullish
+ *
+ * @example
+ * ```ts
+ * // Map input
+ * normalizeMetadataCollection({
+ *   account: { fields: { name: { type: 'text' } } },
+ *   contact: { fields: { email: { type: 'email' } } },
+ * });
+ * // → [
+ * //   { name: 'account', fields: { name: { type: 'text' } } },
+ * //   { name: 'contact', fields: { email: { type: 'email' } } },
+ * // ]
+ *
+ * // Array input (pass-through)
+ * normalizeMetadataCollection([{ name: 'account', fields: {} }]);
+ * // → [{ name: 'account', fields: {} }]
+ * ```
+ */
+declare function normalizeMetadataCollection(value: unknown, keyField?: string): unknown;
+/**
+ * Normalize all metadata collections in a stack definition input.
+ * Converts any map-formatted collections to arrays with key→name injection.
+ *
+ * This function is applied to the raw input before Zod validation,
+ * ensuring the canonical internal format is always arrays.
+ *
+ * @param input - The raw stack definition input
+ * @returns A new object with all map collections normalized to arrays
+ */
+declare function normalizeStackInput<T extends Record<string, unknown>>(input: T): T;
+
 /**
  * Shared Schemas and Utilities
  * Common schemas used across multiple modules
@@ -536,6 +647,9 @@ declare const index$3_FlowNameSchema: typeof FlowNameSchema;
 declare const index$3_HttpMethod: typeof HttpMethod;
 type index$3_IsolationLevel = IsolationLevel;
 declare const index$3_IsolationLevelEnum: typeof IsolationLevelEnum;
+declare const index$3_MAP_SUPPORTED_FIELDS: typeof MAP_SUPPORTED_FIELDS;
+type index$3_MapSupportedField = MapSupportedField;
+type index$3_MetadataCollectionInput<T> = MetadataCollectionInput<T>;
 type index$3_MetadataFormat = MetadataFormat;
 declare const index$3_MetadataFormatSchema: typeof MetadataFormatSchema;
 type index$3_MutationEvent = MutationEvent;
@@ -564,11 +678,13 @@ declare const index$3_formatSuggestion: typeof formatSuggestion;
 declare const index$3_formatZodError: typeof formatZodError;
 declare const index$3_formatZodIssue: typeof formatZodIssue;
 declare const index$3_levenshteinDistance: typeof levenshteinDistance;
+declare const index$3_normalizeMetadataCollection: typeof normalizeMetadataCollection;
+declare const index$3_normalizeStackInput: typeof normalizeStackInput;
 declare const index$3_objectStackErrorMap: typeof objectStackErrorMap;
 declare const index$3_safeParsePretty: typeof safeParsePretty;
 declare const index$3_suggestFieldType: typeof suggestFieldType;
 declare namespace index$3 {
-  export { type index$3_AggregationFunction as AggregationFunction, index$3_AggregationFunctionEnum as AggregationFunctionEnum, type index$3_AppName as AppName, index$3_AppNameSchema as AppNameSchema, type index$3_BaseMetadataRecord as BaseMetadataRecord, index$3_BaseMetadataRecordSchema as BaseMetadataRecordSchema, type index$3_CacheStrategy as CacheStrategy, index$3_CacheStrategyEnum as CacheStrategyEnum, index$3_CorsConfig as CorsConfig, index$3_CorsConfigSchema as CorsConfigSchema, type index$3_EventName as EventName, index$3_EventNameSchema as EventNameSchema, type index$3_FieldMapping as FieldMapping, index$3_FieldMappingSchema as FieldMappingSchema, type index$3_FieldName as FieldName, index$3_FieldNameSchema as FieldNameSchema, type index$3_FlowName as FlowName, index$3_FlowNameSchema as FlowNameSchema, index$3_HttpMethod as HttpMethod, type index$3_IsolationLevel as IsolationLevel, index$3_IsolationLevelEnum as IsolationLevelEnum, type index$3_MetadataFormat as MetadataFormat, index$3_MetadataFormatSchema as MetadataFormatSchema, type index$3_MutationEvent as MutationEvent, index$3_MutationEventEnum as MutationEventEnum, type index$3_ObjectName as ObjectName, index$3_ObjectNameSchema as ObjectNameSchema, type index$3_ObjectStackRawIssue as ObjectStackRawIssue, index$3_RateLimitConfig as RateLimitConfig, index$3_RateLimitConfigSchema as RateLimitConfigSchema, type index$3_RoleName as RoleName, index$3_RoleNameSchema as RoleNameSchema, type index$3_SnakeCaseIdentifier as SnakeCaseIdentifier, index$3_SnakeCaseIdentifierSchema as SnakeCaseIdentifierSchema, type index$3_SortDirection as SortDirection, index$3_SortDirectionEnum as SortDirectionEnum, index$3_StaticMount as StaticMount, index$3_StaticMountSchema as StaticMountSchema, type index$3_SystemIdentifier as SystemIdentifier, index$3_SystemIdentifierSchema as SystemIdentifierSchema, type index$3_TransformType as TransformType, index$3_TransformTypeSchema as TransformTypeSchema, type index$3_ViewName as ViewName, index$3_ViewNameSchema as ViewNameSchema, index$3_findClosestMatches as findClosestMatches, index$3_formatSuggestion as formatSuggestion, index$3_formatZodError as formatZodError, index$3_formatZodIssue as formatZodIssue, index$3_levenshteinDistance as levenshteinDistance, index$3_objectStackErrorMap as objectStackErrorMap, index$3_safeParsePretty as safeParsePretty, index$3_suggestFieldType as suggestFieldType };
+  export { type index$3_AggregationFunction as AggregationFunction, index$3_AggregationFunctionEnum as AggregationFunctionEnum, type index$3_AppName as AppName, index$3_AppNameSchema as AppNameSchema, type index$3_BaseMetadataRecord as BaseMetadataRecord, index$3_BaseMetadataRecordSchema as BaseMetadataRecordSchema, type index$3_CacheStrategy as CacheStrategy, index$3_CacheStrategyEnum as CacheStrategyEnum, index$3_CorsConfig as CorsConfig, index$3_CorsConfigSchema as CorsConfigSchema, type index$3_EventName as EventName, index$3_EventNameSchema as EventNameSchema, type index$3_FieldMapping as FieldMapping, index$3_FieldMappingSchema as FieldMappingSchema, type index$3_FieldName as FieldName, index$3_FieldNameSchema as FieldNameSchema, type index$3_FlowName as FlowName, index$3_FlowNameSchema as FlowNameSchema, index$3_HttpMethod as HttpMethod, type index$3_IsolationLevel as IsolationLevel, index$3_IsolationLevelEnum as IsolationLevelEnum, index$3_MAP_SUPPORTED_FIELDS as MAP_SUPPORTED_FIELDS, type index$3_MapSupportedField as MapSupportedField, type index$3_MetadataCollectionInput as MetadataCollectionInput, type index$3_MetadataFormat as MetadataFormat, index$3_MetadataFormatSchema as MetadataFormatSchema, type index$3_MutationEvent as MutationEvent, index$3_MutationEventEnum as MutationEventEnum, type index$3_ObjectName as ObjectName, index$3_ObjectNameSchema as ObjectNameSchema, type index$3_ObjectStackRawIssue as ObjectStackRawIssue, index$3_RateLimitConfig as RateLimitConfig, index$3_RateLimitConfigSchema as RateLimitConfigSchema, type index$3_RoleName as RoleName, index$3_RoleNameSchema as RoleNameSchema, type index$3_SnakeCaseIdentifier as SnakeCaseIdentifier, index$3_SnakeCaseIdentifierSchema as SnakeCaseIdentifierSchema, type index$3_SortDirection as SortDirection, index$3_SortDirectionEnum as SortDirectionEnum, index$3_StaticMount as StaticMount, index$3_StaticMountSchema as StaticMountSchema, type index$3_SystemIdentifier as SystemIdentifier, index$3_SystemIdentifierSchema as SystemIdentifierSchema, type index$3_TransformType as TransformType, index$3_TransformTypeSchema as TransformTypeSchema, type index$3_ViewName as ViewName, index$3_ViewNameSchema as ViewNameSchema, index$3_findClosestMatches as findClosestMatches, index$3_formatSuggestion as formatSuggestion, index$3_formatZodError as formatZodError, index$3_formatZodIssue as formatZodIssue, index$3_levenshteinDistance as levenshteinDistance, index$3_normalizeMetadataCollection as normalizeMetadataCollection, index$3_normalizeStackInput as normalizeStackInput, index$3_objectStackErrorMap as objectStackErrorMap, index$3_safeParsePretty as safeParsePretty, index$3_suggestFieldType as suggestFieldType };
 }
 
 /**
@@ -9037,6 +9153,29 @@ declare const ObjectStackDefinitionSchema: z.ZodObject<{
     }, z.core.$strip>, z.ZodString]>>>;
 }, z.core.$strip>;
 type ObjectStackDefinition = z.infer<typeof ObjectStackDefinitionSchema>;
+/**
+ * Extract the element type from an array type.
+ * @internal
+ */
+type ExtractArrayItem<T> = T extends (infer Item)[] ? Item : never;
+/**
+ * Input type for `defineStack()` that accepts both array and map format
+ * for all named metadata collections.
+ *
+ * Map format allows defining metadata using the key as the `name` field:
+ * ```ts
+ * // Array format (traditional)
+ * objects: [{ name: 'task', fields: { ... } }]
+ *
+ * // Map format (key becomes name)
+ * objects: { task: { fields: { ... } } }
+ * ```
+ *
+ * The output type is always arrays (`ObjectStackDefinition`).
+ */
+type ObjectStackDefinitionInput = Omit<z.input<typeof ObjectStackDefinitionSchema>, MapSupportedField> & {
+    [K in MapSupportedField]?: MetadataCollectionInput<ExtractArrayItem<NonNullable<z.input<typeof ObjectStackDefinitionSchema>[K]>>>;
+};
 declare const ObjectStackSchema: z.ZodObject<{
     manifest: z.ZodOptional<z.ZodObject<{
         id: z.ZodString;
@@ -14524,11 +14663,22 @@ interface DefineStackOptions {
  * // Basic usage (pass-through, backward compatible)
  * const stack = defineStack({ manifest: { ... }, objects: [...] });
  *
+ * // Map format — key becomes `name` field
+ * const stack = defineStack({
+ *   objects: {
+ *     task: { fields: { title: { type: 'text' } } },
+ *     project: { fields: { name: { type: 'text' } } },
+ *   },
+ *   apps: {
+ *     project_manager: { label: 'Project Manager', objects: ['task', 'project'] },
+ *   },
+ * });
+ *
  * // Strict mode — validates that views/workflows reference defined objects
  * const stack = defineStack({ manifest: { ... }, objects: [...], views: [...] }, { strict: true });
  * ```
  */
-declare function defineStack(config: z.input<typeof ObjectStackDefinitionSchema>, options?: DefineStackOptions): ObjectStackDefinition;
+declare function defineStack(config: ObjectStackDefinitionInput, options?: DefineStackOptions): ObjectStackDefinition;
 /**
  * 2. RUNTIME CAPABILITIES PROTOCOL (Dynamic)
  * ----------------------------------------------------------------------
@@ -14905,4 +15055,4 @@ type ObjectUICapabilities = z.infer<typeof ObjectUICapabilitiesSchema>;
 type ObjectOSCapabilities = z.infer<typeof ObjectOSCapabilitiesSchema>;
 type ObjectStackCapabilities = z.infer<typeof ObjectStackCapabilitiesSchema>;
 
-export { index$2 as Cloud, type DefineStackOptions, index as Identity, type ObjectOSCapabilities, ObjectOSCapabilitiesSchema, type ObjectQLCapabilities, ObjectQLCapabilitiesSchema, type ObjectStack, type ObjectStackCapabilities, ObjectStackCapabilitiesSchema, type ObjectStackDefinition, ObjectStackDefinitionSchema, ObjectStackSchema, type ObjectUICapabilities, ObjectUICapabilitiesSchema, index$1 as QA, index$3 as Shared, defineStack, findClosestMatches, formatSuggestion, formatZodError, formatZodIssue, objectStackErrorMap, safeParsePretty, suggestFieldType };
+export { index$2 as Cloud, type DefineStackOptions, index as Identity, MAP_SUPPORTED_FIELDS, type MapSupportedField, type MetadataCollectionInput, type ObjectOSCapabilities, ObjectOSCapabilitiesSchema, type ObjectQLCapabilities, ObjectQLCapabilitiesSchema, type ObjectStack, type ObjectStackCapabilities, ObjectStackCapabilitiesSchema, type ObjectStackDefinition, type ObjectStackDefinitionInput, ObjectStackDefinitionSchema, ObjectStackSchema, type ObjectUICapabilities, ObjectUICapabilitiesSchema, index$1 as QA, index$3 as Shared, defineStack, findClosestMatches, formatSuggestion, formatZodError, formatZodIssue, normalizeMetadataCollection, normalizeStackInput, objectStackErrorMap, safeParsePretty, suggestFieldType };

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export { i as Data } from './index-BqzRvWzp.js';
 export { i as Security } from './index-BfEDC8Lv.js';
 export { i as UI, a as defineApp, d as defineView } from './index-BIVsi6pD.js';
 export { i as System } from './index-DekIwhKw.js';
-export { i as Kernel, P as PluginContext } from './index-EQCE4QcX.js';
+export { i as Kernel, P as PluginContext } from './index-DwefKBPG.js';
 import { F as FilterGroup } from './index-QoFYi7l6.js';
 export { i as AI, d as defineAgent } from './index-QoFYi7l6.js';
 export { i as Automation, d as defineFlow } from './index-BX1zurbZ.js';
@@ -510,6 +510,117 @@ declare function safeParsePretty<T extends z.ZodTypeAny>(schema: T, data: unknow
     formatted: string;
 };
 
+/**
+ * Metadata Collection Utilities
+ *
+ * Provides support for defining metadata collections in either array or map (Record) format.
+ * Map format automatically injects the key as the `name` field, following the same pattern
+ * used by `fields` in ObjectSchema (which already uses `z.record(key, FieldSchema)`).
+ *
+ * ## Usage
+ *
+ * Both formats are accepted and normalized to arrays:
+ *
+ * ```ts
+ * // Array format (traditional)
+ * defineStack({
+ *   objects: [
+ *     { name: 'account', fields: { ... } },
+ *     { name: 'contact', fields: { ... } },
+ *   ]
+ * });
+ *
+ * // Map format (key becomes `name`)
+ * defineStack({
+ *   objects: {
+ *     account: { fields: { ... } },
+ *     contact: { fields: { ... } },
+ *   }
+ * });
+ * ```
+ *
+ * @module
+ */
+/**
+ * Input type for metadata collections: accepts either an array or a named map.
+ * When using map format, the key is injected as the `name` field of each item.
+ *
+ * @typeParam T - The metadata item type (e.g., `ObjectSchema`, `AppSchema`)
+ *
+ * @example
+ * ```ts
+ * // Array format — name is required in each item
+ * const apps: MetadataCollectionInput<App> = [
+ *   { name: 'sales', label: 'Sales' },
+ *   { name: 'service', label: 'Service' },
+ * ];
+ *
+ * // Map format — key serves as name, so name is optional in value
+ * const apps: MetadataCollectionInput<App> = {
+ *   sales: { label: 'Sales' },
+ *   service: { label: 'Service' },
+ * };
+ * ```
+ */
+type MetadataCollectionInput<T> = T[] | Record<string, Omit<T, 'name'> & {
+    name?: string;
+}>;
+/**
+ * List of metadata fields in ObjectStackDefinitionSchema that support map format.
+ * These are fields where each item has a `name` field that can be inferred from the map key.
+ *
+ * Excluded fields:
+ * - `views` — ViewSchema has no `name` field (it's a container with `list`/`form`)
+ * - `objectExtensions` — uses `extend` as its identifier, not `name`
+ * - `data` — DatasetSchema uses `object` as its identifier
+ * - `translations` — TranslationBundleSchema is a record, not a named object
+ * - `plugins` / `devPlugins` — not named metadata schemas
+ */
+declare const MAP_SUPPORTED_FIELDS: readonly ["objects", "apps", "pages", "dashboards", "reports", "actions", "themes", "workflows", "approvals", "flows", "roles", "permissions", "sharingRules", "policies", "apis", "webhooks", "agents", "ragPipelines", "hooks", "mappings", "analyticsCubes", "connectors", "datasources"];
+type MapSupportedField = (typeof MAP_SUPPORTED_FIELDS)[number];
+/**
+ * Normalize a single metadata collection value from map format to array format.
+ * If the input is already an array (or nullish), it is returned unchanged.
+ * If the input is a plain object (map), it is converted to an array where
+ * each key is injected as the `name` field of the corresponding item.
+ *
+ * **Precedence:** If an item already has a `name` property, it is preserved
+ * (the map key is only used as a fallback).
+ *
+ * @param value - The raw input value (array, map, or nullish)
+ * @param keyField - The field name to inject the key into (default: `'name'`)
+ * @returns The normalized array, or the original value if already an array/nullish
+ *
+ * @example
+ * ```ts
+ * // Map input
+ * normalizeMetadataCollection({
+ *   account: { fields: { name: { type: 'text' } } },
+ *   contact: { fields: { email: { type: 'email' } } },
+ * });
+ * // → [
+ * //   { name: 'account', fields: { name: { type: 'text' } } },
+ * //   { name: 'contact', fields: { email: { type: 'email' } } },
+ * // ]
+ *
+ * // Array input (pass-through)
+ * normalizeMetadataCollection([{ name: 'account', fields: {} }]);
+ * // → [{ name: 'account', fields: {} }]
+ * ```
+ */
+declare function normalizeMetadataCollection(value: unknown, keyField?: string): unknown;
+/**
+ * Normalize all metadata collections in a stack definition input.
+ * Converts any map-formatted collections to arrays with key→name injection.
+ *
+ * This function is applied to the raw input before Zod validation,
+ * ensuring the canonical internal format is always arrays.
+ *
+ * @param input - The raw stack definition input
+ * @returns A new object with all map collections normalized to arrays
+ */
+declare function normalizeStackInput<T extends Record<string, unknown>>(input: T): T;
+
 /**
  * Shared Schemas and Utilities
  * Common schemas used across multiple modules
@@ -536,6 +647,9 @@ declare const index$3_FlowNameSchema: typeof FlowNameSchema;
 declare const index$3_HttpMethod: typeof HttpMethod;
 type index$3_IsolationLevel = IsolationLevel;
 declare const index$3_IsolationLevelEnum: typeof IsolationLevelEnum;
+declare const index$3_MAP_SUPPORTED_FIELDS: typeof MAP_SUPPORTED_FIELDS;
+type index$3_MapSupportedField = MapSupportedField;
+type index$3_MetadataCollectionInput<T> = MetadataCollectionInput<T>;
 type index$3_MetadataFormat = MetadataFormat;
 declare const index$3_MetadataFormatSchema: typeof MetadataFormatSchema;
 type index$3_MutationEvent = MutationEvent;
@@ -564,11 +678,13 @@ declare const index$3_formatSuggestion: typeof formatSuggestion;
 declare const index$3_formatZodError: typeof formatZodError;
 declare const index$3_formatZodIssue: typeof formatZodIssue;
 declare const index$3_levenshteinDistance: typeof levenshteinDistance;
+declare const index$3_normalizeMetadataCollection: typeof normalizeMetadataCollection;
+declare const index$3_normalizeStackInput: typeof normalizeStackInput;
 declare const index$3_objectStackErrorMap: typeof objectStackErrorMap;
 declare const index$3_safeParsePretty: typeof safeParsePretty;
 declare const index$3_suggestFieldType: typeof suggestFieldType;
 declare namespace index$3 {
-  export { type index$3_AggregationFunction as AggregationFunction, index$3_AggregationFunctionEnum as AggregationFunctionEnum, type index$3_AppName as AppName, index$3_AppNameSchema as AppNameSchema, type index$3_BaseMetadataRecord as BaseMetadataRecord, index$3_BaseMetadataRecordSchema as BaseMetadataRecordSchema, type index$3_CacheStrategy as CacheStrategy, index$3_CacheStrategyEnum as CacheStrategyEnum, index$3_CorsConfig as CorsConfig, index$3_CorsConfigSchema as CorsConfigSchema, type index$3_EventName as EventName, index$3_EventNameSchema as EventNameSchema, type index$3_FieldMapping as FieldMapping, index$3_FieldMappingSchema as FieldMappingSchema, type index$3_FieldName as FieldName, index$3_FieldNameSchema as FieldNameSchema, type index$3_FlowName as FlowName, index$3_FlowNameSchema as FlowNameSchema, index$3_HttpMethod as HttpMethod, type index$3_IsolationLevel as IsolationLevel, index$3_IsolationLevelEnum as IsolationLevelEnum, type index$3_MetadataFormat as MetadataFormat, index$3_MetadataFormatSchema as MetadataFormatSchema, type index$3_MutationEvent as MutationEvent, index$3_MutationEventEnum as MutationEventEnum, type index$3_ObjectName as ObjectName, index$3_ObjectNameSchema as ObjectNameSchema, type index$3_ObjectStackRawIssue as ObjectStackRawIssue, index$3_RateLimitConfig as RateLimitConfig, index$3_RateLimitConfigSchema as RateLimitConfigSchema, type index$3_RoleName as RoleName, index$3_RoleNameSchema as RoleNameSchema, type index$3_SnakeCaseIdentifier as SnakeCaseIdentifier, index$3_SnakeCaseIdentifierSchema as SnakeCaseIdentifierSchema, type index$3_SortDirection as SortDirection, index$3_SortDirectionEnum as SortDirectionEnum, index$3_StaticMount as StaticMount, index$3_StaticMountSchema as StaticMountSchema, type index$3_SystemIdentifier as SystemIdentifier, index$3_SystemIdentifierSchema as SystemIdentifierSchema, type index$3_TransformType as TransformType, index$3_TransformTypeSchema as TransformTypeSchema, type index$3_ViewName as ViewName, index$3_ViewNameSchema as ViewNameSchema, index$3_findClosestMatches as findClosestMatches, index$3_formatSuggestion as formatSuggestion, index$3_formatZodError as formatZodError, index$3_formatZodIssue as formatZodIssue, index$3_levenshteinDistance as levenshteinDistance, index$3_objectStackErrorMap as objectStackErrorMap, index$3_safeParsePretty as safeParsePretty, index$3_suggestFieldType as suggestFieldType };
+  export { type index$3_AggregationFunction as AggregationFunction, index$3_AggregationFunctionEnum as AggregationFunctionEnum, type index$3_AppName as AppName, index$3_AppNameSchema as AppNameSchema, type index$3_BaseMetadataRecord as BaseMetadataRecord, index$3_BaseMetadataRecordSchema as BaseMetadataRecordSchema, type index$3_CacheStrategy as CacheStrategy, index$3_CacheStrategyEnum as CacheStrategyEnum, index$3_CorsConfig as CorsConfig, index$3_CorsConfigSchema as CorsConfigSchema, type index$3_EventName as EventName, index$3_EventNameSchema as EventNameSchema, type index$3_FieldMapping as FieldMapping, index$3_FieldMappingSchema as FieldMappingSchema, type index$3_FieldName as FieldName, index$3_FieldNameSchema as FieldNameSchema, type index$3_FlowName as FlowName, index$3_FlowNameSchema as FlowNameSchema, index$3_HttpMethod as HttpMethod, type index$3_IsolationLevel as IsolationLevel, index$3_IsolationLevelEnum as IsolationLevelEnum, index$3_MAP_SUPPORTED_FIELDS as MAP_SUPPORTED_FIELDS, type index$3_MapSupportedField as MapSupportedField, type index$3_MetadataCollectionInput as MetadataCollectionInput, type index$3_MetadataFormat as MetadataFormat, index$3_MetadataFormatSchema as MetadataFormatSchema, type index$3_MutationEvent as MutationEvent, index$3_MutationEventEnum as MutationEventEnum, type index$3_ObjectName as ObjectName, index$3_ObjectNameSchema as ObjectNameSchema, type index$3_ObjectStackRawIssue as ObjectStackRawIssue, index$3_RateLimitConfig as RateLimitConfig, index$3_RateLimitConfigSchema as RateLimitConfigSchema, type index$3_RoleName as RoleName, index$3_RoleNameSchema as RoleNameSchema, type index$3_SnakeCaseIdentifier as SnakeCaseIdentifier, index$3_SnakeCaseIdentifierSchema as SnakeCaseIdentifierSchema, type index$3_SortDirection as SortDirection, index$3_SortDirectionEnum as SortDirectionEnum, index$3_StaticMount as StaticMount, index$3_StaticMountSchema as StaticMountSchema, type index$3_SystemIdentifier as SystemIdentifier, index$3_SystemIdentifierSchema as SystemIdentifierSchema, type index$3_TransformType as TransformType, index$3_TransformTypeSchema as TransformTypeSchema, type index$3_ViewName as ViewName, index$3_ViewNameSchema as ViewNameSchema, index$3_findClosestMatches as findClosestMatches, index$3_formatSuggestion as formatSuggestion, index$3_formatZodError as formatZodError, index$3_formatZodIssue as formatZodIssue, index$3_levenshteinDistance as levenshteinDistance, index$3_normalizeMetadataCollection as normalizeMetadataCollection, index$3_normalizeStackInput as normalizeStackInput, index$3_objectStackErrorMap as objectStackErrorMap, index$3_safeParsePretty as safeParsePretty, index$3_suggestFieldType as suggestFieldType };
 }
 
 /**
@@ -9037,6 +9153,29 @@ declare const ObjectStackDefinitionSchema: z.ZodObject<{
     }, z.core.$strip>, z.ZodString]>>>;
 }, z.core.$strip>;
 type ObjectStackDefinition = z.infer<typeof ObjectStackDefinitionSchema>;
+/**
+ * Extract the element type from an array type.
+ * @internal
+ */
+type ExtractArrayItem<T> = T extends (infer Item)[] ? Item : never;
+/**
+ * Input type for `defineStack()` that accepts both array and map format
+ * for all named metadata collections.
+ *
+ * Map format allows defining metadata using the key as the `name` field:
+ * ```ts
+ * // Array format (traditional)
+ * objects: [{ name: 'task', fields: { ... } }]
+ *
+ * // Map format (key becomes name)
+ * objects: { task: { fields: { ... } } }
+ * ```
+ *
+ * The output type is always arrays (`ObjectStackDefinition`).
+ */
+type ObjectStackDefinitionInput = Omit<z.input<typeof ObjectStackDefinitionSchema>, MapSupportedField> & {
+    [K in MapSupportedField]?: MetadataCollectionInput<ExtractArrayItem<NonNullable<z.input<typeof ObjectStackDefinitionSchema>[K]>>>;
+};
 declare const ObjectStackSchema: z.ZodObject<{
     manifest: z.ZodOptional<z.ZodObject<{
         id: z.ZodString;
@@ -14524,11 +14663,22 @@ interface DefineStackOptions {
  * // Basic usage (pass-through, backward compatible)
  * const stack = defineStack({ manifest: { ... }, objects: [...] });
  *
+ * // Map format — key becomes `name` field
+ * const stack = defineStack({
+ *   objects: {
+ *     task: { fields: { title: { type: 'text' } } },
+ *     project: { fields: { name: { type: 'text' } } },
+ *   },
+ *   apps: {
+ *     project_manager: { label: 'Project Manager', objects: ['task', 'project'] },
+ *   },
+ * });
+ *
  * // Strict mode — validates that views/workflows reference defined objects
  * const stack = defineStack({ manifest: { ... }, objects: [...], views: [...] }, { strict: true });
  * ```
  */
-declare function defineStack(config: z.input<typeof ObjectStackDefinitionSchema>, options?: DefineStackOptions): ObjectStackDefinition;
+declare function defineStack(config: ObjectStackDefinitionInput, options?: DefineStackOptions): ObjectStackDefinition;
 /**
  * 2. RUNTIME CAPABILITIES PROTOCOL (Dynamic)
  * ----------------------------------------------------------------------
@@ -14905,4 +15055,4 @@ type ObjectUICapabilities = z.infer<typeof ObjectUICapabilitiesSchema>;
 type ObjectOSCapabilities = z.infer<typeof ObjectOSCapabilitiesSchema>;
 type ObjectStackCapabilities = z.infer<typeof ObjectStackCapabilitiesSchema>;
 
-export { index$2 as Cloud, type DefineStackOptions, index as Identity, type ObjectOSCapabilities, ObjectOSCapabilitiesSchema, type ObjectQLCapabilities, ObjectQLCapabilitiesSchema, type ObjectStack, type ObjectStackCapabilities, ObjectStackCapabilitiesSchema, type ObjectStackDefinition, ObjectStackDefinitionSchema, ObjectStackSchema, type ObjectUICapabilities, ObjectUICapabilitiesSchema, index$1 as QA, index$3 as Shared, defineStack, findClosestMatches, formatSuggestion, formatZodError, formatZodIssue, objectStackErrorMap, safeParsePretty, suggestFieldType };
+export { index$2 as Cloud, type DefineStackOptions, index as Identity, MAP_SUPPORTED_FIELDS, type MapSupportedField, type MetadataCollectionInput, type ObjectOSCapabilities, ObjectOSCapabilitiesSchema, type ObjectQLCapabilities, ObjectQLCapabilitiesSchema, type ObjectStack, type ObjectStackCapabilities, ObjectStackCapabilitiesSchema, type ObjectStackDefinition, type ObjectStackDefinitionInput, ObjectStackDefinitionSchema, ObjectStackSchema, type ObjectUICapabilities, ObjectUICapabilitiesSchema, index$1 as QA, index$3 as Shared, defineStack, findClosestMatches, formatSuggestion, formatZodError, formatZodIssue, normalizeMetadataCollection, normalizeStackInput, objectStackErrorMap, safeParsePretty, suggestFieldType };

package/dist/index.js

@@ -22,6 +22,7 @@ __export(shared_exports, {
   FlowNameSchema: () => FlowNameSchema,
   HttpMethod: () => HttpMethod,
   IsolationLevelEnum: () => IsolationLevelEnum,
+  MAP_SUPPORTED_FIELDS: () => MAP_SUPPORTED_FIELDS,
   MetadataFormatSchema: () => MetadataFormatSchema,
   MutationEventEnum: () => MutationEventEnum,
   ObjectNameSchema: () => ObjectNameSchema,
@@ -38,6 +39,8 @@ __export(shared_exports, {
   formatZodError: () => formatZodError,
   formatZodIssue: () => formatZodIssue,
   levenshteinDistance: () => levenshteinDistance,
+  normalizeMetadataCollection: () => normalizeMetadataCollection,
+  normalizeStackInput: () => normalizeStackInput,
   objectStackErrorMap: () => objectStackErrorMap,
   safeParsePretty: () => safeParsePretty,
   suggestFieldType: () => suggestFieldType
@@ -894,6 +897,58 @@ function safeParsePretty(schema, data, label) {
   };
 }
 
+// src/shared/metadata-collection.zod.ts
+var MAP_SUPPORTED_FIELDS = [
+  "objects",
+  "apps",
+  "pages",
+  "dashboards",
+  "reports",
+  "actions",
+  "themes",
+  "workflows",
+  "approvals",
+  "flows",
+  "roles",
+  "permissions",
+  "sharingRules",
+  "policies",
+  "apis",
+  "webhooks",
+  "agents",
+  "ragPipelines",
+  "hooks",
+  "mappings",
+  "analyticsCubes",
+  "connectors",
+  "datasources"
+];
+function normalizeMetadataCollection(value, keyField = "name") {
+  if (value == null || Array.isArray(value)) return value;
+  if (typeof value === "object") {
+    return Object.entries(value).map(([key, item]) => {
+      if (item && typeof item === "object" && !Array.isArray(item)) {
+        const obj = item;
+        if (!(keyField in obj) || obj[keyField] === void 0) {
+          return { ...obj, [keyField]: key };
+        }
+        return obj;
+      }
+      return item;
+    });
+  }
+  return value;
+}
+function normalizeStackInput(input) {
+  const result = { ...input };
+  for (const field of MAP_SUPPORTED_FIELDS) {
+    if (field in result) {
+      result[field] = normalizeMetadataCollection(result[field]);
+    }
+  }
+  return result;
+}
+
 // src/data/index.ts
 var data_exports = {};
 __export(data_exports, {
@@ -11715,6 +11770,7 @@ __export(kernel_exports, {
   PluginUpdateStrategySchema: () => PluginUpdateStrategySchema,
   PluginVendorSchema: () => PluginVendorSchema,
   PluginVersionMetadataSchema: () => PluginVersionMetadataSchema,
+  PreviewModeConfigSchema: () => PreviewModeConfigSchema,
   ProtocolFeatureSchema: () => ProtocolFeatureSchema,
   ProtocolReferenceSchema: () => ProtocolReferenceSchema,
   ProtocolVersionSchema: () => ProtocolVersionSchema,
@@ -11797,9 +11853,42 @@ var RuntimeMode = zod.z.enum([
   // Optimized, strict security
   "test",
   // Mocked interfaces
-  "provisioning"
+  "provisioning",
   // Setup/Migration mode
+  "preview"
+  // Demo/preview mode — bypass auth, simulate admin identity
 ]).describe("Kernel operating mode");
+var PreviewModeConfigSchema = zod.z.object({
+  /**
+   * Automatically log in as a simulated user on startup.
+   * When enabled, the frontend skips login/registration screens entirely.
+   */
+  autoLogin: zod.z.boolean().default(true).describe("Auto-login as simulated user, skipping login/registration pages"),
+  /**
+   * Role of the simulated user.
+   * Determines the permission level of the auto-created preview session.
+   */
+  simulatedRole: zod.z.enum(["admin", "user", "viewer"]).default("admin").describe("Permission role for the simulated preview user"),
+  /**
+   * Display name for the simulated user shown in the UI.
+   */
+  simulatedUserName: zod.z.string().default("Preview User").describe("Display name for the simulated preview user"),
+  /**
+   * Whether the preview session is read-only.
+   * When true, all write operations (create, update, delete) are blocked.
+   */
+  readOnly: zod.z.boolean().default(false).describe("Restrict the preview session to read-only operations"),
+  /**
+   * Session duration in seconds. After expiry the preview session ends.
+   * 0 means no expiration.
+   */
+  expiresInSeconds: zod.z.number().int().min(0).default(0).describe("Preview session duration in seconds (0 = no expiration)"),
+  /**
+   * Optional banner message shown in the UI to indicate preview mode.
+   * Useful for marketplace demos so visitors know they are in a sandbox.
+   */
+  bannerMessage: zod.z.string().optional().describe("Banner message displayed in the UI during preview mode")
+});
 var KernelContextSchema = zod.z.object({
   /**
    * Instance Identity
@@ -11823,7 +11912,13 @@ var KernelContextSchema = zod.z.object({
   /**
    * Feature Flags (Global)
    */
-  features: zod.z.record(zod.z.string(), zod.z.boolean()).default({}).describe("Global feature toggles")
+  features: zod.z.record(zod.z.string(), zod.z.boolean()).default({}).describe("Global feature toggles"),
+  /**
+   * Preview Mode Configuration.
+   * Only relevant when `mode` is `'preview'`. Configures auto-login,
+   * simulated identity, read-only restrictions, and UI banner.
+   */
+  previewMode: PreviewModeConfigSchema.optional().describe('Preview/demo mode configuration (used when mode is "preview")')
 });
 var DevServiceOverrideSchema = zod.z.object({
   /** Service identifier (e.g. 'auth', 'eventBus', 'fileStorage') */
@@ -34057,10 +34152,11 @@ function validateCrossReferences(config) {
 }
 function defineStack(config, options) {
   const strict = options?.strict !== false;
+  const normalized = normalizeStackInput(config);
   if (!strict) {
-    return config;
+    return normalized;
   }
-  const result = ObjectStackDefinitionSchema.safeParse(config, {
+  const result = ObjectStackDefinitionSchema.safeParse(normalized, {
     error: objectStackErrorMap
   });
   if (!result.success) {
@@ -34201,6 +34297,7 @@ exports.Data = data_exports;
 exports.Identity = identity_exports;
 exports.Integration = integration_exports;
 exports.Kernel = kernel_exports;
+exports.MAP_SUPPORTED_FIELDS = MAP_SUPPORTED_FIELDS;
 exports.ObjectOSCapabilitiesSchema = ObjectOSCapabilitiesSchema;
 exports.ObjectQLCapabilitiesSchema = ObjectQLCapabilitiesSchema;
 exports.ObjectStackCapabilitiesSchema = ObjectStackCapabilitiesSchema;
@@ -34222,6 +34319,8 @@ exports.findClosestMatches = findClosestMatches;
 exports.formatSuggestion = formatSuggestion;
 exports.formatZodError = formatZodError;
 exports.formatZodIssue = formatZodIssue;
+exports.normalizeMetadataCollection = normalizeMetadataCollection;
+exports.normalizeStackInput = normalizeStackInput;
 exports.objectStackErrorMap = objectStackErrorMap;
 exports.safeParsePretty = safeParsePretty;
 exports.suggestFieldType = suggestFieldType;