digital-products 2.0.1

package/src/data.ts

@@ -0,0 +1,129 @@
+/**
+ * Data() - Define structured data
+ */
+
+import type { DataDefinition, IndexDefinition, RelationshipDefinition, ValidationRule } from './types.js'
+import type { SimpleSchema } from 'ai-functions'
+import { registerProduct } from './product.js'
+
+/**
+ * Create a data definition
+ *
+ * @example
+ * ```ts
+ * const userData = Data({
+ *   id: 'users',
+ *   name: 'Users',
+ *   description: 'User data store',
+ *   version: '1.0.0',
+ *   schema: {
+ *     id: 'User ID',
+ *     name: 'User name',
+ *     email: 'User email',
+ *     createdAt: 'Creation timestamp (date)',
+ *     role: 'admin | user | guest',
+ *   },
+ *   provider: 'postgres',
+ *   indexes: [
+ *     Index('email_idx', ['email'], { unique: true }),
+ *     Index('role_idx', ['role']),
+ *   ],
+ *   validation: [
+ *     Validate('email', 'email', 'Must be a valid email'),
+ *     Validate('name', 'required', 'Name is required'),
+ *   ],
+ * })
+ * ```
+ */
+export function Data(config: Omit<DataDefinition, 'type'>): DataDefinition {
+  const data: DataDefinition = {
+    type: 'data',
+    id: config.id,
+    name: config.name,
+    description: config.description,
+    version: config.version,
+    schema: config.schema,
+    provider: config.provider || 'fs',
+    indexes: config.indexes,
+    relationships: config.relationships,
+    validation: config.validation,
+    metadata: config.metadata,
+    tags: config.tags,
+    status: config.status || 'active',
+  }
+
+  return registerProduct(data)
+}
+
+/**
+ * Helper to create an index definition
+ *
+ * @example
+ * ```ts
+ * const emailIndex = Index('email_idx', ['email'], { unique: true })
+ * const nameIndex = Index('name_idx', ['firstName', 'lastName'])
+ * const vectorIndex = Index('embedding_idx', ['embedding'], { type: 'vector' })
+ * ```
+ */
+export function Index(
+  name: string,
+  fields: string[],
+  options?: Omit<IndexDefinition, 'name' | 'fields'>
+): IndexDefinition {
+  return {
+    name,
+    fields,
+    ...options,
+  }
+}
+
+/**
+ * Helper to create a relationship definition
+ *
+ * @example
+ * ```ts
+ * const userPosts = Relationship('one-to-many', 'userId', 'posts', 'author')
+ * const postTags = Relationship('many-to-many', 'postId', 'tags', 'posts')
+ * ```
+ */
+export function Relationship(
+  type: RelationshipDefinition['type'],
+  from: string,
+  to: string,
+  field: string
+): RelationshipDefinition {
+  return {
+    type,
+    from,
+    to,
+    field,
+  }
+}
+
+/**
+ * Helper to create a validation rule
+ *
+ * @example
+ * ```ts
+ * const emailRule = Validate('email', 'email', 'Must be a valid email')
+ * const ageRule = Validate('age', 'min', { value: 18 }, 'Must be 18 or older')
+ * const uniqueRule = Validate('username', 'unique', 'Username already taken')
+ * ```
+ */
+export function Validate(
+  field: string,
+  rule: ValidationRule['rule'],
+  paramsOrMessage?: unknown | string,
+  message?: string
+): ValidationRule {
+  if (typeof paramsOrMessage === 'string') {
+    return { field, rule, message: paramsOrMessage }
+  }
+
+  return {
+    field,
+    rule,
+    params: paramsOrMessage,
+    message,
+  }
+}

package/src/dataset.ts

@@ -0,0 +1,53 @@
+/**
+ * Dataset() - Define a dataset
+ */
+
+import type { DatasetDefinition } from './types.js'
+import { registerProduct } from './product.js'
+
+/**
+ * Create a dataset definition
+ *
+ * @example
+ * ```ts
+ * const movieDataset = Dataset({
+ *   id: 'movies',
+ *   name: 'Movie Database',
+ *   description: 'Comprehensive movie information dataset',
+ *   version: '2024.1',
+ *   format: 'parquet',
+ *   schema: {
+ *     id: 'Movie ID',
+ *     title: 'Movie title',
+ *     year: 'Release year (number)',
+ *     genres: ['Array of genre names'],
+ *     rating: 'Average rating (number)',
+ *     votes: 'Number of votes (number)',
+ *   },
+ *   source: 's3://datasets/movies.parquet',
+ *   size: 1000000,
+ *   license: 'CC-BY-4.0',
+ *   updateFrequency: 'daily',
+ * })
+ * ```
+ */
+export function Dataset(config: Omit<DatasetDefinition, 'type'>): DatasetDefinition {
+  const dataset: DatasetDefinition = {
+    type: 'dataset',
+    id: config.id,
+    name: config.name,
+    description: config.description,
+    version: config.version,
+    format: config.format || 'json',
+    schema: config.schema,
+    source: config.source,
+    size: config.size,
+    license: config.license,
+    updateFrequency: config.updateFrequency || 'static',
+    metadata: config.metadata,
+    tags: config.tags,
+    status: config.status || 'active',
+  }
+
+  return registerProduct(dataset)
+}