@dotdo/do 0.1.0

package/dist/db/collections/base.js

@@ -0,0 +1,510 @@
+/**
+ * Base Collection - Generic CRUD operations for DO collections
+ *
+ * @module collections/base
+ *
+ * @description
+ * Provides the foundational collection interface that all specialized collections
+ * extend. Uses Durable Object SQLite storage for persistence.
+ *
+ * @example
+ * ```typescript
+ * class CustomerCollection extends BaseCollection<Customer> {
+ *   constructor(ctx: DurableObjectState) {
+ *     super(ctx, 'customers', 'cust')
+ *   }
+ * }
+ *
+ * const customers = new CustomerCollection(ctx)
+ * const customer = await customers.create({ name: 'Acme' })
+ * ```
+ */
+/**
+ * Base collection class providing generic CRUD operations
+ *
+ * @description
+ * All DO collections extend this class to inherit standard CRUD operations,
+ * filtering, pagination, and storage abstraction. The class is generic over
+ * the entity type T, which must have an 'id' field.
+ *
+ * @typeParam T - Entity type with required 'id' field
+ *
+ * @example
+ * ```typescript
+ * interface Product {
+ *   id: string
+ *   name: string
+ *   price: number
+ *   createdAt: number
+ *   updatedAt: number
+ * }
+ *
+ * class ProductCollection extends BaseCollection<Product> {
+ *   constructor(storage: DOStorage) {
+ *     super(storage, { name: 'products', idPrefix: 'prod' })
+ *   }
+ *
+ *   // Add domain-specific methods
+ *   async findByPriceRange(min: number, max: number): Promise<Product[]> {
+ *     return this.find({
+ *       and: [
+ *         { field: 'price', op: 'gte', value: min },
+ *         { field: 'price', op: 'lte', value: max }
+ *       ]
+ *     })
+ *   }
+ * }
+ * ```
+ */
+export class BaseCollection {
+    /**
+     * DO storage interface
+     */
+    storage;
+    /**
+     * Collection configuration
+     */
+    config;
+    /**
+     * Create a new BaseCollection instance
+     *
+     * @param storage - DO storage interface
+     * @param config - Collection configuration
+     */
+    constructor(storage, config) {
+        this.storage = storage;
+        this.config = {
+            defaultLimit: 50,
+            maxLimit: 1000,
+            ...config,
+        };
+    }
+    /**
+     * Generate a unique ID for a new entity
+     *
+     * @returns A unique ID in format '{prefix}_{nanoid}'
+     *
+     * @example
+     * ```typescript
+     * const id = this.generateId() // 'cust_V1StGXR8_Z5jdHi6B-myT'
+     * ```
+     */
+    generateId() {
+        // TODO: Implement nanoid generation
+        const random = Math.random().toString(36).substring(2, 15);
+        return `${this.config.idPrefix}_${random}`;
+    }
+    /**
+     * Get current timestamp in Unix milliseconds
+     *
+     * @returns Current time as Unix timestamp (ms)
+     */
+    now() {
+        return Date.now();
+    }
+    /**
+     * List entities with pagination and filtering
+     *
+     * @param options - List options including limit, offset, cursor, ordering, and filter
+     * @returns Paginated list result with items and metadata
+     *
+     * @example
+     * ```typescript
+     * // Simple pagination
+     * const page1 = await collection.list({ limit: 10 })
+     * const page2 = await collection.list({ limit: 10, cursor: page1.cursor })
+     *
+     * // With filtering
+     * const active = await collection.list({
+     *   filter: { field: 'status', op: 'eq', value: 'active' },
+     *   orderBy: 'createdAt',
+     *   orderDir: 'desc'
+     * })
+     * ```
+     */
+    async list(options = {}) {
+        const limit = Math.min(options.limit ?? this.config.defaultLimit, this.config.maxLimit);
+        const offset = options.offset ?? 0;
+        // Get all items from storage
+        const prefix = `${this.config.name}:`;
+        const allItems = await this.storage.list({ prefix });
+        // Convert to array
+        let items = Array.from(allItems.values());
+        // Apply filtering
+        if (options.filter) {
+            items = items.filter(item => this.matchesFilter(item, options.filter));
+        }
+        const total = items.length;
+        // Apply ordering
+        if (options.orderBy) {
+            const dir = options.orderDir === 'desc' ? -1 : 1;
+            items.sort((a, b) => {
+                const aVal = a[options.orderBy];
+                const bVal = b[options.orderBy];
+                if (aVal === bVal)
+                    return 0;
+                if (aVal === undefined || aVal === null)
+                    return dir;
+                if (bVal === undefined || bVal === null)
+                    return -dir;
+                if (typeof aVal === 'string' && typeof bVal === 'string') {
+                    return aVal.localeCompare(bVal) * dir;
+                }
+                return aVal < bVal ? -dir : dir;
+            });
+        }
+        // Handle cursor-based pagination
+        let startIndex = offset;
+        if (options.cursor) {
+            const cursorIndex = items.findIndex(item => item.id === options.cursor);
+            if (cursorIndex >= 0) {
+                startIndex = cursorIndex + 1;
+            }
+        }
+        // Apply pagination
+        const paginatedItems = items.slice(startIndex, startIndex + limit);
+        const hasMore = startIndex + limit < items.length;
+        // Generate cursor for next page
+        const cursor = paginatedItems.length > 0 ? paginatedItems[paginatedItems.length - 1].id : undefined;
+        return {
+            items: paginatedItems,
+            total,
+            cursor,
+            hasMore,
+        };
+    }
+    /**
+     * Get a single entity by ID
+     *
+     * @param id - Entity ID
+     * @returns The entity or null if not found
+     *
+     * @example
+     * ```typescript
+     * const customer = await customers.get('cust_abc123')
+     * if (customer) {
+     *   console.log(customer.name)
+     * }
+     * ```
+     */
+    async get(id) {
+        if (!id)
+            return null;
+        const key = `${this.config.name}:${id}`;
+        const entity = await this.storage.get(key);
+        return entity ?? null;
+    }
+    /**
+     * Create a new entity
+     *
+     * @param data - Entity data without ID (ID is auto-generated)
+     * @returns The created entity with generated ID and timestamps
+     *
+     * @throws {Error} If creation fails due to validation or storage error
+     *
+     * @example
+     * ```typescript
+     * const customer = await customers.create({
+     *   name: 'Acme Corp',
+     *   email: 'contact@acme.com'
+     * })
+     * console.log(customer.id) // 'cust_abc123'
+     * ```
+     */
+    async create(data) {
+        if (data === null || data === undefined) {
+            throw new ValidationError('Data cannot be null or undefined');
+        }
+        const id = this.generateId();
+        const timestamp = this.now();
+        const entity = {
+            ...data,
+            id,
+            createdAt: timestamp,
+            updatedAt: timestamp,
+        };
+        const key = `${this.config.name}:${id}`;
+        await this.storage.put(key, entity);
+        return entity;
+    }
+    /**
+     * Update an existing entity
+     *
+     * @param id - Entity ID
+     * @param data - Partial entity data to merge
+     * @returns The updated entity
+     *
+     * @throws {Error} If entity not found or update fails
+     *
+     * @example
+     * ```typescript
+     * const updated = await customers.update('cust_abc123', {
+     *   email: 'new@acme.com'
+     * })
+     * ```
+     */
+    async update(id, data) {
+        const existing = await this.get(id);
+        if (!existing) {
+            throw new NotFoundError(this.config.name, id);
+        }
+        // Merge data but preserve id and update timestamp
+        const updated = {
+            ...existing,
+            ...data,
+            id: existing.id, // Preserve original ID
+            updatedAt: this.now(),
+        };
+        const key = `${this.config.name}:${id}`;
+        await this.storage.put(key, updated);
+        return updated;
+    }
+    /**
+     * Delete an entity by ID
+     *
+     * @param id - Entity ID
+     *
+     * @example
+     * ```typescript
+     * await customers.delete('cust_abc123')
+     * ```
+     */
+    async delete(id) {
+        const key = `${this.config.name}:${id}`;
+        await this.storage.delete(key);
+    }
+    /**
+     * Count entities matching a filter
+     *
+     * @param filter - Optional filter expression
+     * @returns Count of matching entities
+     *
+     * @example
+     * ```typescript
+     * const total = await customers.count()
+     * const active = await customers.count({
+     *   field: 'status', op: 'eq', value: 'active'
+     * })
+     * ```
+     */
+    async count(filter) {
+        const prefix = `${this.config.name}:`;
+        const allItems = await this.storage.list({ prefix });
+        if (!filter) {
+            return allItems.size;
+        }
+        let count = 0;
+        for (const item of allItems.values()) {
+            if (this.matchesFilter(item, filter)) {
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * Find entities matching a filter
+     *
+     * @param filter - Filter expression
+     * @returns Array of matching entities
+     *
+     * @example
+     * ```typescript
+     * const highValue = await customers.find({
+     *   and: [
+     *     { field: 'totalSpent', op: 'gte', value: 10000 },
+     *     { field: 'status', op: 'eq', value: 'active' }
+     *   ]
+     * })
+     * ```
+     */
+    async find(filter) {
+        const prefix = `${this.config.name}:`;
+        const allItems = await this.storage.list({ prefix });
+        const results = [];
+        for (const item of allItems.values()) {
+            if (this.matchesFilter(item, filter)) {
+                results.push(item);
+            }
+        }
+        return results;
+    }
+    /**
+     * Check if an entity matches a filter expression
+     *
+     * @param entity - The entity to check
+     * @param filter - The filter expression
+     * @returns True if the entity matches the filter
+     *
+     * @internal
+     */
+    matchesFilter(entity, filter) {
+        // Handle AND conditions
+        if ('and' in filter) {
+            return filter.and.every(f => this.matchesFilter(entity, f));
+        }
+        // Handle OR conditions
+        if ('or' in filter) {
+            return filter.or.some(f => this.matchesFilter(entity, f));
+        }
+        // Handle NOT conditions
+        if ('not' in filter) {
+            return !this.matchesFilter(entity, filter.not);
+        }
+        // Handle field conditions
+        const { field, op, value } = filter;
+        const entityValue = entity[field];
+        switch (op) {
+            case 'eq':
+                return entityValue === value;
+            case 'ne':
+                return entityValue !== value;
+            case 'gt':
+                return entityValue > value;
+            case 'gte':
+                return entityValue >= value;
+            case 'lt':
+                return entityValue < value;
+            case 'lte':
+                return entityValue <= value;
+            case 'in':
+                return value.includes(entityValue);
+            case 'nin':
+                return !value.includes(entityValue);
+            case 'contains':
+                return typeof entityValue === 'string' && entityValue.includes(value);
+            case 'startsWith':
+                return typeof entityValue === 'string' && entityValue.startsWith(value);
+            case 'endsWith':
+                return typeof entityValue === 'string' && entityValue.endsWith(value);
+            default:
+                return false;
+        }
+    }
+    /**
+     * Build SQL WHERE clause from filter expression
+     *
+     * @param filter - Filter expression
+     * @returns Object with SQL clause and parameter values
+     *
+     * @internal
+     */
+    buildWhereClause(filter) {
+        // Handle AND conditions
+        if ('and' in filter) {
+            const clauses = filter.and.map(f => this.buildWhereClause(f));
+            return {
+                sql: `(${clauses.map(c => c.sql).join(' AND ')})`,
+                params: clauses.flatMap(c => c.params),
+            };
+        }
+        // Handle OR conditions
+        if ('or' in filter) {
+            const clauses = filter.or.map(f => this.buildWhereClause(f));
+            return {
+                sql: `(${clauses.map(c => c.sql).join(' OR ')})`,
+                params: clauses.flatMap(c => c.params),
+            };
+        }
+        // Handle NOT conditions
+        if ('not' in filter) {
+            const clause = this.buildWhereClause(filter.not);
+            return {
+                sql: `NOT (${clause.sql})`,
+                params: clause.params,
+            };
+        }
+        // Handle field conditions
+        const { field, op, value } = filter;
+        const sqlOp = this.operatorToSql(op);
+        switch (op) {
+            case 'in':
+            case 'nin': {
+                const values = value;
+                const placeholders = values.map(() => '?').join(', ');
+                return {
+                    sql: `${field} ${sqlOp} (${placeholders})`,
+                    params: values,
+                };
+            }
+            case 'contains':
+                return {
+                    sql: `${field} ${sqlOp} ?`,
+                    params: [`%${value}%`],
+                };
+            case 'startsWith':
+                return {
+                    sql: `${field} ${sqlOp} ?`,
+                    params: [`${value}%`],
+                };
+            case 'endsWith':
+                return {
+                    sql: `${field} ${sqlOp} ?`,
+                    params: [`%${value}`],
+                };
+            default:
+                return {
+                    sql: `${field} ${sqlOp} ?`,
+                    params: [value],
+                };
+        }
+    }
+    /**
+     * Convert filter operator to SQL operator
+     *
+     * @param op - Filter operator
+     * @returns SQL operator string
+     *
+     * @internal
+     */
+    operatorToSql(op) {
+        const opMap = {
+            eq: '=',
+            ne: '!=',
+            gt: '>',
+            gte: '>=',
+            lt: '<',
+            lte: '<=',
+            in: 'IN',
+            nin: 'NOT IN',
+            contains: 'LIKE',
+            startsWith: 'LIKE',
+            endsWith: 'LIKE',
+        };
+        return opMap[op];
+    }
+}
+/**
+ * Collection error types
+ */
+export class CollectionError extends Error {
+    code;
+    entityId;
+    constructor(message, code, entityId) {
+        super(message);
+        this.code = code;
+        this.entityId = entityId;
+        this.name = 'CollectionError';
+    }
+}
+/**
+ * Entity not found error
+ */
+export class NotFoundError extends CollectionError {
+    constructor(collection, id) {
+        super(`${collection} with id '${id}' not found`, 'NOT_FOUND', id);
+        this.name = 'NotFoundError';
+    }
+}
+/**
+ * Validation error
+ */
+export class ValidationError extends CollectionError {
+    field;
+    constructor(message, field) {
+        super(message, 'VALIDATION');
+        this.field = field;
+        this.name = 'ValidationError';
+    }
+}
+export default BaseCollection;
+//# sourceMappingURL=base.js.map

package/dist/db/collections/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../db/collections/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAuFH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,OAAgB,cAAc;IAGlC;;OAEG;IACgB,OAAO,CAAW;IAErC;;OAEG;IACgB,MAAM,CAA4B;IAErD;;;;;OAKG;IACH,YAAY,OAAkB,EAAE,MAAwB;QACtD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,MAAM,GAAG;YACZ,YAAY,EAAE,EAAE;YAChB,QAAQ,EAAE,IAAI;YACd,GAAG,MAAM;SACV,CAAA;IACH,CAAC;IAED;;;;;;;;;OASG;IACO,UAAU;QAClB,oCAAoC;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QAC1D,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,EAAE,CAAA;IAC5C,CAAC;IAED;;;;OAIG;IACO,GAAG;QACX,OAAO,IAAI,CAAC,GAAG,EAAE,CAAA;IACnB,CAAC;IAWD;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,CAAC,IAAI,CAAC,UAAuB,EAAE;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QACvF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAA;QAElC,6BAA6B;QAC7B,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,CAAA;QACrC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAI,EAAE,MAAM,EAAE,CAAC,CAAA;QAEvD,mBAAmB;QACnB,IAAI,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;QAEzC,kBAAkB;QAClB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,MAAO,CAAC,CAAC,CAAA;QACzE,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAA;QAE1B,iBAAiB;QACjB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;YAChD,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBAClB,MAAM,IAAI,GAAI,CAA6B,CAAC,OAAO,CAAC,OAAQ,CAAC,CAAA;gBAC7D,MAAM,IAAI,GAAI,CAA6B,CAAC,OAAO,CAAC,OAAQ,CAAC,CAAA;gBAC7D,IAAI,IAAI,KAAK,IAAI;oBAAE,OAAO,CAAC,CAAA;gBAC3B,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI;oBAAE,OAAO,GAAG,CAAA;gBACnD,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI;oBAAE,OAAO,CAAC,GAAG,CAAA;gBACpD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACzD,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,GAAG,CAAA;gBACvC,CAAC;gBACD,OAAO,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAA;YACjC,CAAC,CAAC,CAAA;QACJ,CAAC;QAED,iCAAiC;QACjC,IAAI,UAAU,GAAG,MAAM,CAAA;QACvB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;YACvE,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;gBACrB,UAAU,GAAG,WAAW,GAAG,CAAC,CAAA;YAC9B,CAAC;QACH,CAAC;QAED,mBAAmB;QACnB,MAAM,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,GAAG,KAAK,CAAC,CAAA;QAClE,MAAM,OAAO,GAAG,UAAU,GAAG,KAAK,GAAG,KAAK,CAAC,MAAM,CAAA;QAEjD,gCAAgC;QAChC,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;QAEnG,OAAO;YACL,KAAK,EAAE,cAAc;YACrB,KAAK;YACL,MAAM;YACN,OAAO;SACR,CAAA;IACH,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAA;QACpB,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE,CAAA;QACvC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAI,GAAG,CAAC,CAAA;QAC7C,OAAO,MAAM,IAAI,IAAI,CAAA;IACvB,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,MAAM,CAAC,IAAmB;QAC9B,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACxC,MAAM,IAAI,eAAe,CAAC,kCAAkC,CAAC,CAAA;QAC/D,CAAC;QAED,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,CAAA;QAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAE5B,MAAM,MAAM,GAAG;YACb,GAAG,IAAI;YACP,EAAE;YACF,SAAS,EAAE,SAAS;YACpB,SAAS,EAAE,SAAS;SACL,CAAA;QAEjB,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE,CAAA;QACvC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;QAEnC,OAAO,MAAM,CAAA;IACf,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,IAAgB;QACvC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACnC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;QAC/C,CAAC;QAED,kDAAkD;QAClD,MAAM,OAAO,GAAG;YACd,GAAG,QAAQ;YACX,GAAG,IAAI;YACP,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,uBAAuB;YACxC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACjB,CAAA;QAEN,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE,CAAA;QACvC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QAEpC,OAAO,OAAO,CAAA;IAChB,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE,CAAA;QACvC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAChC,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,KAAK,CAAC,MAAyB;QACnC,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,CAAA;QACrC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAI,EAAE,MAAM,EAAE,CAAC,CAAA;QAEvD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,QAAQ,CAAC,IAAI,CAAA;QACtB,CAAC;QAED,IAAI,KAAK,GAAG,CAAC,CAAA;QACb,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YACrC,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;gBACrC,KAAK,EAAE,CAAA;YACT,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,IAAI,CAAC,MAAwB;QACjC,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,CAAA;QACrC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAI,EAAE,MAAM,EAAE,CAAC,CAAA;QAEvD,MAAM,OAAO,GAAQ,EAAE,CAAA;QACvB,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YACrC,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;gBACrC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACpB,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;IAED;;;;;;;;OAQG;IACO,aAAa,CAAC,MAAS,EAAE,MAAwB;QACzD,wBAAwB;QACxB,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;YACpB,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAA;QAC7D,CAAC;QAED,uBAAuB;QACvB,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;YACnB,OAAO,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAA;QAC3D,CAAC;QAED,wBAAwB;QACxB,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;QAChD,CAAC;QAED,0BAA0B;QAC1B,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,MAAyD,CAAA;QACtF,MAAM,WAAW,GAAI,MAAkC,CAAC,KAAK,CAAC,CAAA;QAE9D,QAAQ,EAAE,EAAE,CAAC;YACX,KAAK,IAAI;gBACP,OAAO,WAAW,KAAK,KAAK,CAAA;YAC9B,KAAK,IAAI;gBACP,OAAO,WAAW,KAAK,KAAK,CAAA;YAC9B,KAAK,IAAI;gBACP,OAAQ,WAAsB,GAAI,KAAgB,CAAA;YACpD,KAAK,KAAK;gBACR,OAAQ,WAAsB,IAAK,KAAgB,CAAA;YACrD,KAAK,IAAI;gBACP,OAAQ,WAAsB,GAAI,KAAgB,CAAA;YACpD,KAAK,KAAK;gBACR,OAAQ,WAAsB,IAAK,KAAgB,CAAA;YACrD,KAAK,IAAI;gBACP,OAAQ,KAAmB,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;YACnD,KAAK,KAAK;gBACR,OAAO,CAAE,KAAmB,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;YACpD,KAAK,UAAU;gBACb,OAAO,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,QAAQ,CAAC,KAAe,CAAC,CAAA;YACjF,KAAK,YAAY;gBACf,OAAO,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,UAAU,CAAC,KAAe,CAAC,CAAA;YACnF,KAAK,UAAU;gBACb,OAAO,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,QAAQ,CAAC,KAAe,CAAC,CAAA;YACjF;gBACE,OAAO,KAAK,CAAA;QAChB,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACO,gBAAgB,CAAC,MAAwB;QAIjD,wBAAwB;QACxB,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;YACpB,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAA;YAC7D,OAAO;gBACL,GAAG,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG;gBACjD,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;aACvC,CAAA;QACH,CAAC;QAED,uBAAuB;QACvB,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;YACnB,MAAM,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAA;YAC5D,OAAO;gBACL,GAAG,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG;gBAChD,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;aACvC,CAAA;QACH,CAAC;QAED,wBAAwB;QACxB,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;YACpB,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YAChD,OAAO;gBACL,GAAG,EAAE,QAAQ,MAAM,CAAC,GAAG,GAAG;gBAC1B,MAAM,EAAE,MAAM,CAAC,MAAM;aACtB,CAAA;QACH,CAAC;QAED,0BAA0B;QAC1B,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,MAAyD,CAAA;QACtF,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAA;QAEpC,QAAQ,EAAE,EAAE,CAAC;YACX,KAAK,IAAI,CAAC;YACV,KAAK,KAAK,CAAC,CAAC,CAAC;gBACX,MAAM,MAAM,GAAG,KAAkB,CAAA;gBACjC,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBACrD,OAAO;oBACL,GAAG,EAAE,GAAG,KAAK,IAAI,KAAK,KAAK,YAAY,GAAG;oBAC1C,MAAM,EAAE,MAAM;iBACf,CAAA;YACH,CAAC;YACD,KAAK,UAAU;gBACb,OAAO;oBACL,GAAG,EAAE,GAAG,KAAK,IAAI,KAAK,IAAI;oBAC1B,MAAM,EAAE,CAAC,IAAI,KAAK,GAAG,CAAC;iBACvB,CAAA;YACH,KAAK,YAAY;gBACf,OAAO;oBACL,GAAG,EAAE,GAAG,KAAK,IAAI,KAAK,IAAI;oBAC1B,MAAM,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC;iBACtB,CAAA;YACH,KAAK,UAAU;gBACb,OAAO;oBACL,GAAG,EAAE,GAAG,KAAK,IAAI,KAAK,IAAI;oBAC1B,MAAM,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;iBACtB,CAAA;YACH;gBACE,OAAO;oBACL,GAAG,EAAE,GAAG,KAAK,IAAI,KAAK,IAAI;oBAC1B,MAAM,EAAE,CAAC,KAAK,CAAC;iBAChB,CAAA;QACL,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACO,aAAa,CAAC,EAAY;QAClC,MAAM,KAAK,GAA6B;YACtC,EAAE,EAAE,GAAG;YACP,EAAE,EAAE,IAAI;YACR,EAAE,EAAE,GAAG;YACP,GAAG,EAAE,IAAI;YACT,EAAE,EAAE,GAAG;YACP,GAAG,EAAE,IAAI;YACT,EAAE,EAAE,IAAI;YACR,GAAG,EAAE,QAAQ;YACb,QAAQ,EAAE,MAAM;YAChB,UAAU,EAAE,MAAM;YAClB,QAAQ,EAAE,MAAM;SACjB,CAAA;QACD,OAAO,KAAK,CAAC,EAAE,CAAC,CAAA;IAClB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAGtB;IACA;IAHlB,YACE,OAAe,EACC,IAAyD,EACzD,QAAiB;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAA;QAHE,SAAI,GAAJ,IAAI,CAAqD;QACzD,aAAQ,GAAR,QAAQ,CAAS;QAGjC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;IAC/B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,eAAe;IAChD,YAAY,UAAkB,EAAE,EAAU;QACxC,KAAK,CAAC,GAAG,UAAU,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,EAAE,CAAC,CAAA;QACjE,IAAI,CAAC,IAAI,GAAG,eAAe,CAAA;IAC7B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,eAAe;IACL;IAA7C,YAAY,OAAe,EAAkB,KAAc;QACzD,KAAK,CAAC,OAAO,EAAE,YAAY,CAAC,CAAA;QADe,UAAK,GAAL,KAAK,CAAS;QAEzD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;IAC/B,CAAC;CACF;AAED,eAAe,cAAc,CAAA"}

package/dist/db/collections/index.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Collections Module - Core data structures for Digital Objects
+ *
+ * @module collections
+ *
+ * @description
+ * This module exports all collection types for managing data within Digital Objects.
+ * Collections provide the core data layer including:
+ *
+ * - **Nouns**: Entity type registry (Customer, Order, Product, etc.)
+ * - **Verbs**: Action type registry (create, update, delete, approve, etc.)
+ * - **Things**: Entity instances in ThingExpanded or ThingCompact formats
+ * - **Actions**: Durable action execution with full lifecycle tracking
+ * - **Relationships**: Graph-style entity linking with cascade operator support
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   NounCollection,
+ *   VerbCollection,
+ *   ThingCollection,
+ *   ActionCollection,
+ *   RelationshipCollection
+ * } from './collections'
+ *
+ * // Initialize collections with storage
+ * const nouns = new NounCollection(storage)
+ * const verbs = new VerbCollection(storage)
+ * const things = new ThingCollection(storage, nouns)
+ * const actions = new ActionCollection(storage, verbs)
+ * const relationships = new RelationshipCollection(storage)
+ * ```
+ */
+export { BaseCollection, CollectionError, NotFoundError, ValidationError, } from './base';
+export type { DOStorage, CollectionConfig, } from './base';
+export { NounCollection, } from './nouns';
+export type { CreateNounOptions, } from './nouns';
+export { VerbCollection, CRUD_VERBS, WORKFLOW_VERBS, } from './verbs';
+export type { CreateVerbOptions, } from './verbs';
+export { ThingCollection, } from './things';
+export type { CreateThingExpandedOptions, CreateThingCompactOptions, ThingQueryOptions, } from './things';
+export { ActionCollection, DEFAULT_RETRY_POLICY, } from './actions';
+export type { CreateActionOptions, FailActionOptions, ActionRetryPolicy, } from './actions';
+export { RelationshipCollection, } from './relationships';
+export type { CreateRelationshipOptions, RelationshipQueryOptions, TraversalResult, } from './relationships';
+export type { Noun, Verb, Thing, ThingExpanded, ThingCompact, Action, ActionStatus, ActionError, ActionRequest, Actor, ActorType, Relationship, Function, FunctionType, FunctionDefinition, Workflow, WorkflowType, WorkflowExecutionState, WorkflowDefinition, WorkflowStep, WorkflowTrigger, StateMachineDefinition, StateNode, Transition, Event, Experiment, ExperimentStatus, Variant, Org, Role, Permission, User, Agent, AgentStatus, AgentModality, Integration, IntegrationStatus, IntegrationCredentials, Webhook, CollectionMethods, ListOptions, ListResult, FilterExpression, FilterOp, } from '../../types/collections';
+export { isThingExpanded, isThingCompact } from '../../types/collections';
+export type { RelationOperator, RelationDirection, RelationMethod, RelationFieldDefinition, StoredRelation, RelationManager, CascadeProcessor, CascadeResult, CascadeFieldResult, CascadeError, CascadeConfig, CascadeEvent, } from '../../types/cascade';
+export { parseRelationOperator, parseRelationField, isRelationField, } from '../../types/cascade';
+//# sourceMappingURL=index.d.ts.map

package/dist/db/collections/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../db/collections/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAGH,OAAO,EACL,cAAc,EACd,eAAe,EACf,aAAa,EACb,eAAe,GAChB,MAAM,QAAQ,CAAA;AAEf,YAAY,EACV,SAAS,EACT,gBAAgB,GACjB,MAAM,QAAQ,CAAA;AAGf,OAAO,EACL,cAAc,GACf,MAAM,SAAS,CAAA;AAEhB,YAAY,EACV,iBAAiB,GAClB,MAAM,SAAS,CAAA;AAGhB,OAAO,EACL,cAAc,EACd,UAAU,EACV,cAAc,GACf,MAAM,SAAS,CAAA;AAEhB,YAAY,EACV,iBAAiB,GAClB,MAAM,SAAS,CAAA;AAGhB,OAAO,EACL,eAAe,GAChB,MAAM,UAAU,CAAA;AAEjB,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,UAAU,CAAA;AAGjB,OAAO,EACL,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,WAAW,CAAA;AAElB,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,WAAW,CAAA;AAGlB,OAAO,EACL,sBAAsB,GACvB,MAAM,iBAAiB,CAAA;AAExB,YAAY,EACV,yBAAyB,EACzB,wBAAwB,EACxB,eAAe,GAChB,MAAM,iBAAiB,CAAA;AAGxB,YAAY,EACV,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,aAAa,EACb,YAAY,EACZ,MAAM,EACN,YAAY,EACZ,WAAW,EACX,aAAa,EACb,KAAK,EACL,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,kBAAkB,EAClB,QAAQ,EACR,YAAY,EACZ,sBAAsB,EACtB,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,sBAAsB,EACtB,SAAS,EACT,UAAU,EACV,KAAK,EACL,UAAU,EACV,gBAAgB,EAChB,OAAO,EACP,GAAG,EACH,IAAI,EACJ,UAAU,EACV,IAAI,EACJ,KAAK,EACL,WAAW,EACX,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,sBAAsB,EACtB,OAAO,EACP,iBAAiB,EACjB,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,QAAQ,GACT,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAGzE,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,uBAAuB,EACvB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,YAAY,GACb,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,GAChB,MAAM,qBAAqB,CAAA"}

package/dist/db/collections/index.js

@@ -0,0 +1,48 @@
+/**
+ * Collections Module - Core data structures for Digital Objects
+ *
+ * @module collections
+ *
+ * @description
+ * This module exports all collection types for managing data within Digital Objects.
+ * Collections provide the core data layer including:
+ *
+ * - **Nouns**: Entity type registry (Customer, Order, Product, etc.)
+ * - **Verbs**: Action type registry (create, update, delete, approve, etc.)
+ * - **Things**: Entity instances in ThingExpanded or ThingCompact formats
+ * - **Actions**: Durable action execution with full lifecycle tracking
+ * - **Relationships**: Graph-style entity linking with cascade operator support
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   NounCollection,
+ *   VerbCollection,
+ *   ThingCollection,
+ *   ActionCollection,
+ *   RelationshipCollection
+ * } from './collections'
+ *
+ * // Initialize collections with storage
+ * const nouns = new NounCollection(storage)
+ * const verbs = new VerbCollection(storage)
+ * const things = new ThingCollection(storage, nouns)
+ * const actions = new ActionCollection(storage, verbs)
+ * const relationships = new RelationshipCollection(storage)
+ * ```
+ */
+// Base collection
+export { BaseCollection, CollectionError, NotFoundError, ValidationError, } from './base';
+// Noun collection
+export { NounCollection, } from './nouns';
+// Verb collection
+export { VerbCollection, CRUD_VERBS, WORKFLOW_VERBS, } from './verbs';
+// Things collection
+export { ThingCollection, } from './things';
+// Actions collection
+export { ActionCollection, DEFAULT_RETRY_POLICY, } from './actions';
+// Relationships collection
+export { RelationshipCollection, } from './relationships';
+export { isThingExpanded, isThingCompact } from '../../types/collections';
+export { parseRelationOperator, parseRelationField, isRelationField, } from '../../types/cascade';
+//# sourceMappingURL=index.js.map

package/dist/db/collections/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../db/collections/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,kBAAkB;AAClB,OAAO,EACL,cAAc,EACd,eAAe,EACf,aAAa,EACb,eAAe,GAChB,MAAM,QAAQ,CAAA;AAOf,kBAAkB;AAClB,OAAO,EACL,cAAc,GACf,MAAM,SAAS,CAAA;AAMhB,kBAAkB;AAClB,OAAO,EACL,cAAc,EACd,UAAU,EACV,cAAc,GACf,MAAM,SAAS,CAAA;AAMhB,oBAAoB;AACpB,OAAO,EACL,eAAe,GAChB,MAAM,UAAU,CAAA;AAQjB,qBAAqB;AACrB,OAAO,EACL,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,WAAW,CAAA;AAQlB,2BAA2B;AAC3B,OAAO,EACL,sBAAsB,GACvB,MAAM,iBAAiB,CAAA;AAwDxB,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAkBzE,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,GAChB,MAAM,qBAAqB,CAAA"}