feat: Add Datasource and Manifest schemas for ObjectStack configuration

Author: hotlong

packages/spec/src/system/datasource.zod.ts

@@ -0,0 +1,63 @@
+import { z } from 'zod';
+import { SnakeCaseIdentifierSchema } from '../shared/identifiers.zod';
+
+/**
+ * Datasource Type Enum
+ * Supported external data connection types.
+ */
+export const DatasourceTypeSchema = z.enum([
+  'postgres',
+  'mysql',
+  'sqlserver',
+  'oracle',
+  'mongodb',
+  'redis',
+  'elasticsearch',
+  'salesforce',
+  'sap',
+  'http',
+  'other'
+]);
+
+/**
+ * Datasource Protocol
+ * 
+ * Defines external data connections for the ObjectStack Runtime.
+ * Used to virtualize data from SQL, NoSQL, and SaaS providers.
+ */
+export const DatasourceSchema = z.object({
+  /** 
+   * Unique machine identifier for the datasource.
+   * Used in object definitions to reference this source.
+   */
+  name: SnakeCaseIdentifierSchema.describe('Unique machine identifier (snake_case)'),
+
+  /** Display label for the datasource */
+  label: z.string().optional().describe('Display label'),
+
+  /** Description */
+  description: z.string().optional().describe('Description of the data source'),
+
+  /** Connection Type */
+  type: DatasourceTypeSchema.describe('Type of data source'),
+
+  /** 
+   * Connection Configuration
+   * Driver-specific settings (host, port, credentials, connection string).
+   * Note: Secrets should be referenced via ENV variables, not hardcoded.
+   */
+  config: z.record(z.any()).default({}).describe('Driver specific configuration'),
+
+  /** Enable/Disable this datasource */
+  enable: z.boolean().default(true).describe('Enable this datasource'),
+
+  /** Read-only mode */
+  readOnly: z.boolean().default(false).describe('If true, writes are disabled'),
+});
+
+export const Datasource = Object.assign(DatasourceSchema, {
+  create: <T extends z.input<typeof DatasourceSchema>>(config: T) => config,
+});
+
+export type DatasourceType = z.infer<typeof DatasourceTypeSchema>;
+export type Datasource = z.infer<typeof DatasourceSchema>;

packages/spec/src/system/index.ts

@@ -8,6 +8,8 @@
  */
 
 export * from './audit.zod';
+export * from './manifest.zod';
+export * from './datasource.zod';
 export * from './translation.zod';
 export * from './events.zod';
 export * from './job.zod';

packages/spec/src/system/manifest.zod.ts

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+import { SnakeCaseIdentifierSchema } from '../shared/identifiers.zod';
+import { DatasourceSchema } from './datasource.zod';
+import { AppSchema } from '../ui/app.zod';
+
+/**
+ * ObjectStack Manifest Protocol
+ * 
+ * The root configuration for an ObjectStack Package or Project.
+ * Typically defined in `objectstack.config.ts`.
+ * 
+ * Acts as the entry point for the runtime to discover:
+ * - Apps
+ * - Datasources
+ * - Objects (often referenced within Apps, but can be top-level)
+ * - Policies & Permissions
+ */
+export const ManifestSchema = z.object({
+  /** Package Name */
+  name: SnakeCaseIdentifierSchema.describe('Package machine name'),
+
+  /** Semantic Version */
+  version: z.string().regex(/^\d+\.\d+\.\d+$/).describe('Semantic version (x.y.z)'),
+
+  /** Display Label */
+  label: z.string().optional().describe('Package display label'),
+
+  /** Package Description */
+  description: z.string().optional().describe('Package description'),
+
+  /** 
+   * Included Apps
+   * Applications provide the UI and navigation structure.
+   */
+  apps: z.array(AppSchema).optional().describe('Applications included in this package'),
+
+  /**
+   * System Datasources
+   * External connections utilized by objects in this package.
+   */
+  datasources: z.array(DatasourceSchema).optional().describe('Datasources defined in this package'),
+
+  /**
+   * Global Configuration
+   */
+  config: z.record(z.any()).optional().describe('Global package configuration'),
+  
+  /**
+   * Plugins
+   * List of plugins to load.
+   */
+  plugins: z.array(z.string()).optional().describe('List of plugin names (npm packages)'),
+});
+
+export const Manifest = Object.assign(ManifestSchema, {
+  create: <T extends z.input<typeof ManifestSchema>>(config: T) => config,
+});
+
+export type Manifest = z.infer<typeof ManifestSchema>;