@soulcraft/sdk 1.6.2 → 2.0.0

package/dist/server/handlers/collections.js

@@ -0,0 +1,484 @@
+/**
+ * @module server/handlers/collections
+ * @description Collections namespace handler — view collection CRUD, member
+ * management, and sample data seeding.
+ *
+ * Absorbs Workshop `routes/collections.ts`. Collections are Brainy entities
+ * of type `Collection` with `isViewCollection: true` metadata. Members are
+ * linked via `Contains` relationships. Virtual collections (Everything,
+ * Uncategorized) are computed dynamically.
+ *
+ * Methods:
+ * - `list` — List all view collections (real + virtual)
+ * - `get` — Get a single collection by ID
+ * - `create` — Create a new collection (optionally with sample data)
+ * - `update` — Update collection name/metadata
+ * - `delete` — Delete a collection (members are NOT deleted)
+ * - `getMembers` — Get entities belonging to a collection
+ * - `addMember` — Add an entity to a collection
+ * - `removeMember` — Remove an entity from a collection
+ * - `loadSampleData` — Seed sample data for a kit
+ * - `clearSampleData` — Remove all sample data entities
+ */
+// ─────────────────────────────────────────────────────────────────────────────
+// Helpers
+// ─────────────────────────────────────────────────────────────────────────────
+/** Virtual collection IDs. */
+const VIRTUAL_IDS = {
+    EXPLORE: '__virtual_explore__',
+    UNCATEGORIZED: '__virtual_uncategorized__',
+};
+/**
+ * Check if a collection ID is a virtual collection.
+ *
+ * @param id - Collection ID to check.
+ * @returns `true` if virtual.
+ */
+function isVirtual(id) {
+    return id.startsWith('__virtual_');
+}
+/**
+ * Get the list of virtual collections.
+ *
+ * @returns Virtual collection definitions.
+ */
+function getVirtualCollections() {
+    return [
+        {
+            id: VIRTUAL_IDS.EXPLORE,
+            name: 'Everything',
+            type: 'virtual',
+            memberCount: 0,
+        },
+        {
+            id: VIRTUAL_IDS.UNCATEGORIZED,
+            name: 'Uncategorized',
+            type: 'virtual',
+            memberCount: 0,
+        },
+    ];
+}
+/**
+ * Extract a display name from a Brainy entity.
+ *
+ * @param entity - Brainy entity.
+ * @returns Display name.
+ */
+function extractName(entity) {
+    const meta = entity.metadata || {};
+    return meta.name || meta.label || (typeof entity.data === 'string' ? entity.data : entity.id);
+}
+/**
+ * Check if a relationship type is a "Contains" relationship.
+ *
+ * @param type - Relationship type string.
+ * @returns `true` if it's a contains relationship.
+ */
+function isContainsRelation(type) {
+    const lower = type.toLowerCase();
+    return lower === 'contains' || lower === 'has' || lower === 'includes';
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Handler factory
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Creates the `collections` namespace handler.
+ *
+ * @param options - Optional collections handler configuration.
+ * @returns A {@link NamespaceProvider} implementing {@link CollectionsNamespace}.
+ */
+export function createCollectionsHandler(options) {
+    const sampleData = options?.sampleData;
+    return {
+        /**
+         * List all view collections in the workspace.
+         *
+         * Returns virtual collections (Everything, Uncategorized) first, followed
+         * by user-created collections. Member counts are deferred (always 0 on list).
+         *
+         * @param listOptions - Filtering options.
+         * @param ctx - Handler context with Brainy instance.
+         * @returns Array of collections.
+         */
+        async list(listOptions, ctx) {
+            const { brain } = ctx;
+            // Fetch real collections (Collection entities with isViewCollection metadata)
+            const results = await brain.find({
+                where: { type: 'Collection' },
+                limit: 1000,
+            });
+            const realCollections = results
+                .filter((entity) => {
+                const meta = entity.metadata || {};
+                return meta.isViewCollection === true;
+            })
+                .map((entity) => {
+                const meta = entity.metadata || {};
+                return {
+                    id: entity.id,
+                    name: extractName(entity),
+                    type: meta.viewType || 'graph',
+                    memberCount: 0, // Deferred — too slow on list
+                    metadata: {
+                        icon: meta.icon,
+                        color: meta.color,
+                        defaultNounType: meta.defaultNounType,
+                        createdAt: meta.createdAt,
+                    },
+                };
+            });
+            // Apply type filter if specified
+            const typeFilter = listOptions?.type;
+            const filtered = typeFilter
+                ? realCollections.filter(c => c.type === typeFilter)
+                : realCollections;
+            return [...getVirtualCollections(), ...filtered];
+        },
+        /**
+         * Get a single collection by ID.
+         *
+         * @param collectionId - Collection ID (real or virtual).
+         * @param ctx - Handler context.
+         * @returns The collection or `null`.
+         */
+        async get(collectionId, ctx) {
+            // Handle virtual collections
+            if (isVirtual(collectionId)) {
+                const virtualDef = getVirtualCollections().find(v => v.id === collectionId);
+                if (!virtualDef)
+                    return null;
+                // Count members for virtual collections
+                const allEntities = await ctx.brain.find({ limit: 10000, excludeVFS: true });
+                virtualDef.memberCount = allEntities.length;
+                return virtualDef;
+            }
+            // Real collection
+            const entity = await ctx.brain.get(collectionId);
+            if (!entity)
+                return null;
+            const meta = entity.metadata || {};
+            // Count members via outgoing Contains relationships
+            let memberCount = 0;
+            try {
+                const outgoing = await ctx.brain.getRelations({ from: collectionId }) || [];
+                memberCount = outgoing.filter((rel) => isContainsRelation(rel.type)).length;
+            }
+            catch {
+                // No relations
+            }
+            return {
+                id: entity.id,
+                name: extractName(entity),
+                type: meta.viewType || 'graph',
+                memberCount,
+                metadata: {
+                    icon: meta.icon,
+                    color: meta.color,
+                    defaultNounType: meta.defaultNounType,
+                    createdAt: meta.createdAt,
+                    projectId: meta.projectId,
+                },
+            };
+        },
+        /**
+         * Create a new view collection.
+         *
+         * @param createOptions - Collection properties.
+         * @param ctx - Handler context.
+         * @returns The newly created collection.
+         */
+        async create(createOptions, ctx) {
+            const { brain } = ctx;
+            const { name, type: viewType, metadata: extraMeta } = createOptions;
+            const collectionId = await brain.add({
+                type: 'collection',
+                data: name,
+                metadata: {
+                    name,
+                    label: name,
+                    isViewCollection: true,
+                    viewType,
+                    viewInstanceId: `${viewType}-${Date.now()}`,
+                    icon: extraMeta?.icon || 'folder',
+                    color: extraMeta?.color || '#6366f1',
+                    defaultNounType: extraMeta?.defaultNounType || 'concept',
+                    createdAt: new Date().toISOString(),
+                    ...extraMeta,
+                },
+            });
+            return {
+                id: collectionId,
+                name,
+                type: viewType,
+                memberCount: 0,
+                metadata: extraMeta,
+            };
+        },
+        /**
+         * Update a collection's name or metadata.
+         *
+         * @param collectionId - Collection to update.
+         * @param updates - Fields to update.
+         * @param ctx - Handler context.
+         * @returns The updated collection.
+         */
+        async update(collectionId, updates, ctx) {
+            if (isVirtual(collectionId)) {
+                throw new Error('Cannot modify virtual collections');
+            }
+            const { brain } = ctx;
+            const existing = await brain.get(collectionId);
+            if (!existing) {
+                throw new Error('Collection not found');
+            }
+            const existingMeta = existing.metadata || {};
+            const metadataUpdates = {
+                ...existingMeta,
+                updatedAt: new Date().toISOString(),
+            };
+            if (updates.name) {
+                metadataUpdates.name = updates.name;
+                metadataUpdates.label = updates.name;
+            }
+            if (updates.metadata) {
+                Object.assign(metadataUpdates, updates.metadata);
+            }
+            await brain.update({
+                id: collectionId,
+                data: updates.name || existing.data,
+                metadata: metadataUpdates,
+            });
+            const updated = await brain.get(collectionId);
+            if (!updated)
+                throw new Error('Collection not found after update');
+            return {
+                id: updated.id,
+                name: extractName(updated),
+                type: (updated.metadata || {}).viewType || 'graph',
+                memberCount: 0,
+                metadata: updates.metadata,
+            };
+        },
+        /**
+         * Delete a collection. Member entities are NOT deleted.
+         *
+         * Removes all Contains relationships from the collection first,
+         * then deletes the collection entity itself.
+         *
+         * @param collectionId - Collection to delete.
+         * @param ctx - Handler context.
+         */
+        async delete(collectionId, ctx) {
+            if (isVirtual(collectionId)) {
+                throw new Error('Cannot delete virtual collections');
+            }
+            const { brain } = ctx;
+            const existing = await brain.get(collectionId);
+            if (!existing) {
+                throw new Error('Collection not found');
+            }
+            // Remove all Contains relationships (release members)
+            const outgoing = await brain.getRelations({ from: collectionId }) || [];
+            for (const rel of outgoing) {
+                if (isContainsRelation(rel.type)) {
+                    try {
+                        await brain.unrelate(rel.id);
+                    }
+                    catch {
+                        // Non-fatal — continue with deletion
+                    }
+                }
+            }
+            await brain.delete(collectionId);
+        },
+        /**
+         * Get the entities belonging to a collection.
+         *
+         * @param collectionId - Collection to list members for.
+         * @param ctx - Handler context.
+         * @returns Array of member entity summaries.
+         */
+        async getMembers(collectionId, ctx) {
+            const { brain } = ctx;
+            // Virtual "Everything" collection — return all non-VFS entities
+            if (collectionId === VIRTUAL_IDS.EXPLORE) {
+                const allEntities = await brain.find({ limit: 10000, excludeVFS: true });
+                return allEntities.map((entity) => ({
+                    id: entity.id,
+                    name: extractName(entity),
+                    type: (entity.type || 'concept').toLowerCase(),
+                }));
+            }
+            // Virtual "Uncategorized" — entities not in any real collection
+            if (collectionId === VIRTUAL_IDS.UNCATEGORIZED) {
+                const allEntities = await brain.find({ limit: 10000, excludeVFS: true });
+                const collected = new Set();
+                // Find all entities that are members of any collection
+                const collections = await brain.find({ where: { type: 'Collection' }, limit: 1000 });
+                for (const col of collections) {
+                    const meta = col.metadata || {};
+                    if (!meta.isViewCollection)
+                        continue;
+                    const rels = await brain.getRelations({ from: col.id }) || [];
+                    for (const rel of rels) {
+                        if (isContainsRelation(rel.type))
+                            collected.add(rel.to);
+                    }
+                }
+                return allEntities
+                    .filter((entity) => !collected.has(entity.id) && entity.type !== 'Collection')
+                    .map((entity) => ({
+                    id: entity.id,
+                    name: extractName(entity),
+                    type: (entity.type || 'concept').toLowerCase(),
+                }));
+            }
+            // Real collection — fetch via Contains relationships
+            const outgoing = await brain.getRelations({ from: collectionId }) || [];
+            const memberRels = outgoing.filter((rel) => isContainsRelation(rel.type));
+            const members = [];
+            for (const rel of memberRels) {
+                try {
+                    const entity = await brain.get(rel.to);
+                    if (entity) {
+                        members.push({
+                            id: entity.id,
+                            name: extractName(entity),
+                            type: (entity.type || 'concept').toLowerCase(),
+                        });
+                    }
+                }
+                catch {
+                    // Entity may have been deleted
+                }
+            }
+            return members;
+        },
+        /**
+         * Add an entity to a collection.
+         *
+         * Includes duplicate prevention — won't create a second Contains
+         * relationship if one already exists.
+         *
+         * @param collectionId - Collection to add to.
+         * @param entityId - Entity to add.
+         * @param ctx - Handler context.
+         */
+        async addMember(collectionId, entityId, ctx) {
+            if (isVirtual(collectionId)) {
+                throw new Error('Cannot add entities to virtual collections');
+            }
+            const { brain } = ctx;
+            // Verify both exist
+            const collection = await brain.get(collectionId);
+            if (!collection)
+                throw new Error('Collection not found');
+            const entity = await brain.get(entityId);
+            if (!entity)
+                throw new Error('Entity not found');
+            // Duplicate prevention
+            const existingRels = await brain.getRelations({ from: collectionId, to: entityId }) || [];
+            const alreadyContains = existingRels.some((rel) => isContainsRelation(rel.type));
+            if (alreadyContains)
+                return; // Idempotent
+            await brain.relate({ from: collectionId, to: entityId, type: 'contains' });
+        },
+        /**
+         * Remove an entity from a collection.
+         *
+         * @param collectionId - Collection to remove from.
+         * @param entityId - Entity to remove.
+         * @param ctx - Handler context.
+         */
+        async removeMember(collectionId, entityId, ctx) {
+            if (isVirtual(collectionId)) {
+                throw new Error('Cannot remove entities from virtual collections');
+            }
+            const { brain } = ctx;
+            // Find the Contains relationship
+            const rels = await brain.getRelations({ from: collectionId, to: entityId }) || [];
+            const containsRel = rels.find((r) => isContainsRelation(r.type));
+            if (containsRel) {
+                await brain.unrelate(containsRel.id);
+            }
+        },
+        /**
+         * Load sample data for a given kit.
+         *
+         * Creates entities, adds them to a new collection, and creates
+         * relationships between them.
+         *
+         * @param kitId - Kit whose sample data to load.
+         * @param ctx - Handler context.
+         * @returns Count of entities created.
+         */
+        async loadSampleData(kitId, ctx) {
+            if (!sampleData)
+                return { count: 0 };
+            const data = sampleData.getSampleData(kitId);
+            if (!data)
+                return { count: 0 };
+            const { brain } = ctx;
+            const nameToId = new Map();
+            // Create entities
+            for (const e of data.entities) {
+                try {
+                    const entityId = await brain.add({
+                        type: e.type,
+                        data: e.name,
+                        metadata: {
+                            name: e.name,
+                            description: e.description || '',
+                            isSampleData: true,
+                            ...(e.properties || {}),
+                        },
+                    });
+                    nameToId.set(e.name, entityId);
+                }
+                catch {
+                    // Skip failing entities
+                }
+            }
+            // Create relationships
+            if (data.relationships) {
+                for (const rel of data.relationships) {
+                    const fromId = nameToId.get(rel.from);
+                    const toId = nameToId.get(rel.to);
+                    if (!fromId || !toId)
+                        continue;
+                    try {
+                        await brain.relate({ from: fromId, to: toId, type: rel.type });
+                    }
+                    catch {
+                        // Skip failing relationships
+                    }
+                }
+            }
+            return { count: nameToId.size };
+        },
+        /**
+         * Clear all sample data entities from the workspace.
+         *
+         * Only removes entities with `isSampleData: true` metadata — user-created
+         * entities are never affected.
+         *
+         * @param ctx - Handler context.
+         */
+        async clearSampleData(ctx) {
+            const { brain } = ctx;
+            const allEntities = await brain.find({ limit: 50000 });
+            for (const entity of allEntities) {
+                const meta = entity.metadata || {};
+                if (meta.isSampleData === true) {
+                    try {
+                        await brain.delete(entity.id);
+                    }
+                    catch {
+                        // Non-fatal
+                    }
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=collections.js.map

package/dist/server/handlers/collections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.js","sourceRoot":"","sources":["../../../src/server/handlers/collections.ts"],"names":[],"mappings":"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"}

package/dist/server/handlers/commerce.d.ts

@@ -0,0 +1,106 @@
+/**
+ * @module server/handlers/commerce
+ * @description Commerce namespace handler — product management, checkout, and
+ * payment processing.
+ *
+ * Stripe-first implementation with a pluggable `PaymentProvider` interface.
+ * Products inject their Stripe account credentials via `providers.commerce`
+ * in the SDK server config.
+ *
+ * Methods:
+ * - `createProduct` — Create a new product with pricing
+ * - `listProducts` — List all products
+ * - `getProduct` — Get a single product by ID
+ * - `checkout` — Initiate a Stripe Checkout session
+ * - `getPayment` — Get a payment record
+ * - `listPayments` — List payments for the current user
+ */
+import type { NamespaceProvider } from '../namespace-router.js';
+/**
+ * Payment provider interface — Stripe-first, pluggable for other processors.
+ */
+export interface PaymentProvider {
+    createProduct(options: {
+        name: string;
+        description?: string;
+        priceAmount: number;
+        currency: string;
+        images?: string[];
+        metadata?: Record<string, string>;
+    }): Promise<{
+        id: string;
+        name: string;
+        description: string;
+        priceAmount: number;
+        currency: string;
+        active: boolean;
+        createdAt: string;
+    }>;
+    listProducts(options?: {
+        active?: boolean;
+        limit?: number;
+    }): Promise<Array<{
+        id: string;
+        name: string;
+        description: string;
+        priceAmount: number;
+        currency: string;
+        active: boolean;
+        createdAt: string;
+    }>>;
+    getProduct(productId: string): Promise<{
+        id: string;
+        name: string;
+        description: string;
+        priceAmount: number;
+        currency: string;
+        active: boolean;
+        createdAt: string;
+    } | null>;
+    checkout(options: {
+        items: Array<{
+            productId: string;
+            quantity: number;
+        }>;
+        successUrl: string;
+        cancelUrl: string;
+        customerEmail?: string;
+    }): Promise<{
+        sessionId: string;
+        checkoutUrl: string;
+    }>;
+    getPayment(paymentId: string): Promise<{
+        id: string;
+        amount: number;
+        currency: string;
+        status: string;
+        customerEmail: string;
+        createdAt: string;
+    } | null>;
+    listPayments(options?: {
+        limit?: number;
+        customerEmail?: string;
+    }): Promise<Array<{
+        id: string;
+        amount: number;
+        currency: string;
+        status: string;
+        customerEmail: string;
+        createdAt: string;
+    }>>;
+}
+/**
+ * Options for {@link createCommerceHandler}.
+ */
+export interface CommerceHandlerOptions {
+    /** Payment provider (Stripe, etc.). */
+    paymentProvider: PaymentProvider;
+}
+/**
+ * Creates the `commerce` namespace handler.
+ *
+ * @param options - Commerce handler dependencies. If omitted, all methods throw.
+ * @returns A {@link NamespaceProvider} implementing {@link CommerceNamespace}.
+ */
+export declare function createCommerceHandler(options?: CommerceHandlerOptions): NamespaceProvider;
+//# sourceMappingURL=commerce.d.ts.map

package/dist/server/handlers/commerce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commerce.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/commerce.ts"],"names":[],"mappings":"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"}

package/dist/server/handlers/commerce.js

@@ -0,0 +1,62 @@
+/**
+ * @module server/handlers/commerce
+ * @description Commerce namespace handler — product management, checkout, and
+ * payment processing.
+ *
+ * Stripe-first implementation with a pluggable `PaymentProvider` interface.
+ * Products inject their Stripe account credentials via `providers.commerce`
+ * in the SDK server config.
+ *
+ * Methods:
+ * - `createProduct` — Create a new product with pricing
+ * - `listProducts` — List all products
+ * - `getProduct` — Get a single product by ID
+ * - `checkout` — Initiate a Stripe Checkout session
+ * - `getPayment` — Get a payment record
+ * - `listPayments` — List payments for the current user
+ */
+// ─────────────────────────────────────────────────────────────────────────────
+// Handler factory
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Creates the `commerce` namespace handler.
+ *
+ * @param options - Commerce handler dependencies. If omitted, all methods throw.
+ * @returns A {@link NamespaceProvider} implementing {@link CommerceNamespace}.
+ */
+export function createCommerceHandler(options) {
+    const provider = options?.paymentProvider;
+    function requireProvider() {
+        if (!provider) {
+            throw new Error('commerce namespace is not configured — provide a PaymentProvider via providers.commerce');
+        }
+        return provider;
+    }
+    return {
+        async createProduct(productOptions, ctx) {
+            return requireProvider().createProduct(productOptions);
+        },
+        async listProducts(listOptions) {
+            return requireProvider().listProducts(listOptions);
+        },
+        async getProduct(productId) {
+            return requireProvider().getProduct(productId);
+        },
+        async checkout(checkoutOptions, ctx) {
+            return requireProvider().checkout({
+                ...checkoutOptions,
+                customerEmail: checkoutOptions.customerEmail || ctx.user.email,
+            });
+        },
+        async getPayment(paymentId) {
+            return requireProvider().getPayment(paymentId);
+        },
+        async listPayments(listOptions, ctx) {
+            return requireProvider().listPayments({
+                ...listOptions,
+                customerEmail: ctx.user.email,
+            });
+        },
+    };
+}
+//# sourceMappingURL=commerce.js.map