@proseql/rpc 0.1.0

package/dist/rpc-handlers.d.ts

@@ -0,0 +1,247 @@
+/**
+ * RPC Handler Layer implementation.
+ *
+ * Creates an Effect Layer that provides handlers for all RPC procedures
+ * derived from a DatabaseConfig. The layer internally creates an EffectDatabase
+ * and wires each handler to the appropriate collection method.
+ */
+import { type DatabaseConfig, type DatasetFor, type GenerateDatabase, type GenerateDatabaseWithPersistence, type MigrationError, type PluginError } from "@proseql/core";
+import { Context, Effect, Layer, Stream } from "effect";
+/**
+ * Service tag for providing the database instance to handlers.
+ * This allows handlers to access the database without creating it themselves.
+ */
+export interface DatabaseContext<Config extends DatabaseConfig> {
+    readonly db: GenerateDatabase<Config>;
+}
+/**
+ * Create a Context.Tag for a specific database configuration.
+ * Each config type gets its own unique service identifier.
+ */
+export declare const makeDatabaseContextTag: <Config extends DatabaseConfig>() => Context.Tag<DatabaseContext<Config>, DatabaseContext<Config>>;
+/**
+ * Internal function to create handlers for a single collection.
+ * Returns an object with handler functions for each RPC operation.
+ */
+declare const createCollectionHandlers: <Config extends DatabaseConfig>(collectionName: keyof Config, db: GenerateDatabase<Config>) => {
+    findById: ({ id }: {
+        readonly id: string;
+    }) => any;
+    query: (config: {
+        readonly where?: Record<string, unknown>;
+        readonly populate?: Record<string, unknown>;
+        readonly sort?: Record<string, "asc" | "desc">;
+        readonly select?: Record<string, unknown> | ReadonlyArray<string>;
+        readonly limit?: number;
+        readonly offset?: number;
+    }) => Effect.Effect<readonly Record<string, unknown>[], unknown, never>;
+    queryStream: (config: {
+        readonly where?: Record<string, unknown>;
+        readonly populate?: Record<string, unknown>;
+        readonly sort?: Record<string, "asc" | "desc">;
+        readonly select?: Record<string, unknown> | ReadonlyArray<string>;
+        readonly limit?: number;
+        readonly offset?: number;
+        readonly streamingOptions?: {
+            readonly chunkSize?: number;
+            readonly bufferSize?: number;
+        };
+    }) => Stream.Stream<Record<string, unknown>, unknown, never>;
+    create: ({ data }: {
+        readonly data: Record<string, unknown>;
+    }) => any;
+    createMany: ({ data, options, }: {
+        readonly data: ReadonlyArray<Record<string, unknown>>;
+        readonly options?: {
+            readonly skipDuplicates?: boolean;
+            readonly validateRelationships?: boolean;
+        };
+    }) => any;
+    update: ({ id, updates, }: {
+        readonly id: string;
+        readonly updates: Record<string, unknown>;
+    }) => any;
+    updateMany: ({ where, updates, }: {
+        readonly where: Record<string, unknown>;
+        readonly updates: Record<string, unknown>;
+    }) => any;
+    delete: ({ id }: {
+        readonly id: string;
+    }) => any;
+    deleteMany: ({ where, options, }: {
+        readonly where: Record<string, unknown>;
+        readonly options?: {
+            readonly limit?: number;
+        };
+    }) => any;
+    aggregate: (config: {
+        readonly count?: boolean;
+        readonly sum?: string | ReadonlyArray<string>;
+        readonly avg?: string | ReadonlyArray<string>;
+        readonly min?: string | ReadonlyArray<string>;
+        readonly max?: string | ReadonlyArray<string>;
+        readonly groupBy?: string | ReadonlyArray<string>;
+        readonly where?: Record<string, unknown>;
+    }) => any;
+    upsert: ({ where, create: createData, update: updateData, }: {
+        readonly where: Record<string, unknown>;
+        readonly create: Record<string, unknown>;
+        readonly update: Record<string, unknown>;
+    }) => any;
+    upsertMany: ({ data, }: {
+        readonly data: ReadonlyArray<{
+            readonly where: Record<string, unknown>;
+            readonly create: Record<string, unknown>;
+            readonly update: Record<string, unknown>;
+        }>;
+    }) => any;
+};
+/**
+ * Handler type for the RPC layer.
+ * This is the shape of handlers that need to be provided to the RpcGroup.
+ */
+export type RpcHandlers<Config extends DatabaseConfig> = {
+    readonly [K in keyof Config & string]: ReturnType<typeof createCollectionHandlers<Config>>;
+};
+/**
+ * Create an Effect Layer that provides handlers for all RPC procedures.
+ *
+ * The layer:
+ * 1. Creates an in-memory EffectDatabase from the config and optional initial data
+ * 2. For each collection, wires handlers to the appropriate database methods
+ * 3. Returns a Layer that provides the handler implementations
+ *
+ * @param config - The database configuration defining collections and schemas
+ * @param initialData - Optional initial data to seed the database
+ * @returns An Effect that produces the handler implementations for use with RpcGroup.toLayer
+ *
+ * @example
+ * ```typescript
+ * import { Layer } from "effect"
+ * import { makeRpcHandlers, makeRpcGroup } from "@proseql/rpc"
+ *
+ * const config = {
+ *   books: { schema: BookSchema, relationships: {} },
+ * } as const
+ *
+ * const rpcs = makeRpcGroup(config)
+ *
+ * // Create handler implementations
+ * const handlerEffect = makeRpcHandlers(config, {
+ *   books: [{ id: "1", title: "Dune" }],
+ * })
+ *
+ * // Use with RpcGroup.toLayer for the complete RPC server layer
+ * ```
+ */
+export declare const makeRpcHandlers: <Config extends DatabaseConfig>(config: Config, initialData?: Partial<DatasetFor<Config>>) => Effect.Effect<RpcHandlers<Config>, MigrationError | PluginError>;
+/**
+ * Create an Effect Layer that provides RPC handlers for all collections.
+ *
+ * This is a convenience wrapper that combines makeRpcHandlers with makeRpcGroup
+ * to produce a complete Layer ready for use with Effect RPC server.
+ *
+ * @param config - The database configuration
+ * @param initialData - Optional initial data to seed the database
+ * @returns A Layer providing all RPC handlers
+ *
+ * @example
+ * ```typescript
+ * import { Effect } from "effect"
+ * import { makeRpcHandlersLayer } from "@proseql/rpc"
+ *
+ * const config = {
+ *   books: { schema: BookSchema, relationships: {} },
+ * } as const
+ *
+ * // Create handler layer (can be composed with other layers)
+ * const handlersLayer = makeRpcHandlersLayer(config, {
+ *   books: [{ id: "1", title: "Dune" }],
+ * })
+ * ```
+ */
+export declare const makeRpcHandlersLayer: <Config extends DatabaseConfig>(config: Config, initialData?: Partial<DatasetFor<Config>>) => Layer.Layer<DatabaseContext<Config>, MigrationError | PluginError>;
+/**
+ * Create RPC handlers from an existing database instance.
+ *
+ * This function accepts any EffectDatabase or EffectDatabaseWithPersistence
+ * and wires handlers to delegate to the collection methods. When the database
+ * is a persistent database (created via createPersistentEffectDatabase),
+ * mutations automatically trigger persistence as normal.
+ *
+ * This is the recommended approach for production use cases where you need:
+ * - File-based persistence with debounced writes
+ * - Control over the database lifecycle
+ * - Multiple transports (RPC, REST) sharing the same database instance
+ *
+ * @param config - The database configuration (used to enumerate collections)
+ * @param db - An existing EffectDatabase or EffectDatabaseWithPersistence instance
+ * @returns The RPC handler implementations
+ *
+ * @example
+ * ```typescript
+ * import { Effect, Layer } from "effect"
+ * import { createPersistentEffectDatabase, NodeStorageLayer, makeSerializerLayer, jsonCodec } from "@proseql/node"
+ * import { makeRpcHandlersFromDatabase } from "@proseql/rpc"
+ *
+ * const config = {
+ *   books: {
+ *     schema: BookSchema,
+ *     file: "./data/books.json", // persistence enabled
+ *     relationships: {},
+ *   },
+ * } as const
+ *
+ * const program = Effect.gen(function* () {
+ *   // Create persistent database
+ *   const db = yield* createPersistentEffectDatabase(config, { books: [] })
+ *
+ *   // Wire RPC handlers to the persistent database
+ *   const handlers = makeRpcHandlersFromDatabase(config, db)
+ *
+ *   // Mutations through RPC now trigger persistence automatically
+ *   yield* handlers.books.create({ data: { id: "1", title: "Dune" } })
+ *
+ *   // Flush to ensure data is written
+ *   await db.flush()
+ * })
+ *
+ * const PersistenceLayer = Layer.merge(
+ *   NodeStorageLayer,
+ *   makeSerializerLayer([jsonCodec()]),
+ * )
+ *
+ * await Effect.runPromise(
+ *   program.pipe(Effect.provide(PersistenceLayer), Effect.scoped),
+ * )
+ * ```
+ */
+export declare const makeRpcHandlersFromDatabase: <Config extends DatabaseConfig>(config: Config, db: GenerateDatabase<Config> | GenerateDatabaseWithPersistence<Config>) => RpcHandlers<Config>;
+/**
+ * Create an Effect Layer that provides RPC handlers from an existing database.
+ *
+ * Similar to makeRpcHandlersLayer, but accepts an existing database instance
+ * instead of creating one internally. This allows you to use a persistent
+ * database with the RPC layer.
+ *
+ * @param db - An existing EffectDatabase or EffectDatabaseWithPersistence instance
+ * @returns A Layer providing all RPC handlers via DatabaseContext
+ *
+ * @example
+ * ```typescript
+ * import { Effect, Layer } from "effect"
+ * import { createPersistentEffectDatabase } from "@proseql/node"
+ * import { makeRpcHandlersLayerFromDatabase, makeDatabaseContextTag } from "@proseql/rpc"
+ *
+ * const program = Effect.gen(function* () {
+ *   const db = yield* createPersistentEffectDatabase(config, initialData)
+ *   const handlerLayer = makeRpcHandlersLayerFromDatabase(db)
+ *
+ *   // Use the layer with your RPC server
+ *   // ...
+ * })
+ * ```
+ */
+export declare const makeRpcHandlersLayerFromDatabase: <Config extends DatabaseConfig>(db: GenerateDatabase<Config> | GenerateDatabaseWithPersistence<Config>) => Layer.Layer<DatabaseContext<Config>>;
+export {};
+//# sourceMappingURL=rpc-handlers.d.ts.map

package/dist/rpc-handlers.d.ts.map

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

package/dist/rpc-handlers.js

@@ -0,0 +1,266 @@
+/**
+ * RPC Handler Layer implementation.
+ *
+ * Creates an Effect Layer that provides handlers for all RPC procedures
+ * derived from a DatabaseConfig. The layer internally creates an EffectDatabase
+ * and wires each handler to the appropriate collection method.
+ */
+import { createEffectDatabase, } from "@proseql/core";
+import { Chunk, Context, Effect, Layer, Stream } from "effect";
+/**
+ * Create a Context.Tag for a specific database configuration.
+ * Each config type gets its own unique service identifier.
+ */
+export const makeDatabaseContextTag = () => Context.GenericTag("@proseql/rpc/DatabaseContext");
+// ============================================================================
+// Handler Implementations
+// ============================================================================
+/**
+ * Internal function to create handlers for a single collection.
+ * Returns an object with handler functions for each RPC operation.
+ */
+const createCollectionHandlers = (collectionName, db) => {
+    // biome-ignore lint/suspicious/noExplicitAny: Collection type is dynamic based on config
+    const collection = db[collectionName];
+    return {
+        findById: ({ id }) => collection.findById(id),
+        query: (config) => {
+            // Query returns a RunnableStream; collect it to an array for RPC response
+            const stream = collection.query(config);
+            // The stream is a Stream.Stream at runtime (RunnableStream wrapper)
+            return Stream.runCollect(stream).pipe(Effect.map(Chunk.toReadonlyArray));
+        },
+        queryStream: (config) => {
+            // Return the stream directly for incremental delivery over RPC transport
+            // The RPC layer will serialize stream items as they are emitted
+            const baseStream = collection.query(config);
+            // Apply rechunking if streamingOptions.chunkSize is specified
+            // This batches items into chunks of the specified size before they are
+            // sent over the RPC transport, reducing overhead at the cost of increased
+            // latency to first item. The RPC layer transmits items in chunks, so this
+            // ensures each transmission contains up to `chunkSize` items.
+            //
+            // Note: bufferSize is a client-side hint that should be passed to the
+            // RPC client's streamBufferSize option when making the call.
+            const chunkSize = config.streamingOptions?.chunkSize;
+            if (chunkSize && chunkSize > 1) {
+                return Stream.rechunk(baseStream, chunkSize);
+            }
+            return baseStream;
+        },
+        create: ({ data }) => 
+        // biome-ignore lint/suspicious/noExplicitAny: Data type is dynamic based on schema
+        collection.create(data),
+        createMany: ({ data, options, }) => 
+        // biome-ignore lint/suspicious/noExplicitAny: Data type is dynamic based on schema
+        collection.createMany(data, options),
+        update: ({ id, updates, }) => 
+        // biome-ignore lint/suspicious/noExplicitAny: Updates type is dynamic based on schema
+        collection.update(id, updates),
+        updateMany: ({ where, updates, }) => collection.updateMany(
+        // For RPC we receive where clause, convert to predicate that matches records
+        // biome-ignore lint/suspicious/noExplicitAny: Dynamic predicate - entity type unknown at runtime
+        (entity) => {
+            for (const [key, value] of Object.entries(where)) {
+                if (entity[key] !== value)
+                    return false;
+            }
+            return true;
+        }, 
+        // biome-ignore lint/suspicious/noExplicitAny: Updates type is dynamic based on collection schema
+        updates),
+        delete: ({ id }) => collection.delete(id),
+        deleteMany: ({ where, options, }) => 
+        // biome-ignore lint/suspicious/noExplicitAny: Predicate is dynamic
+        collection.deleteMany((entity) => {
+            for (const [key, value] of Object.entries(where)) {
+                if (entity[key] !== value)
+                    return false;
+            }
+            return true;
+        }, options),
+        aggregate: (config) => 
+        // biome-ignore lint/suspicious/noExplicitAny: Aggregate config is dynamic
+        collection.aggregate(config),
+        upsert: ({ where, create: createData, update: updateData, }) => collection.upsert({
+            where,
+            create: createData,
+            update: updateData,
+            // biome-ignore lint/suspicious/noExplicitAny: Upsert data is dynamic - types unknown at runtime
+        }),
+        upsertMany: ({ data, }) => 
+        // biome-ignore lint/suspicious/noExplicitAny: Upsert data is dynamic
+        collection.upsertMany(data),
+    };
+};
+/**
+ * Create an Effect Layer that provides handlers for all RPC procedures.
+ *
+ * The layer:
+ * 1. Creates an in-memory EffectDatabase from the config and optional initial data
+ * 2. For each collection, wires handlers to the appropriate database methods
+ * 3. Returns a Layer that provides the handler implementations
+ *
+ * @param config - The database configuration defining collections and schemas
+ * @param initialData - Optional initial data to seed the database
+ * @returns An Effect that produces the handler implementations for use with RpcGroup.toLayer
+ *
+ * @example
+ * ```typescript
+ * import { Layer } from "effect"
+ * import { makeRpcHandlers, makeRpcGroup } from "@proseql/rpc"
+ *
+ * const config = {
+ *   books: { schema: BookSchema, relationships: {} },
+ * } as const
+ *
+ * const rpcs = makeRpcGroup(config)
+ *
+ * // Create handler implementations
+ * const handlerEffect = makeRpcHandlers(config, {
+ *   books: [{ id: "1", title: "Dune" }],
+ * })
+ *
+ * // Use with RpcGroup.toLayer for the complete RPC server layer
+ * ```
+ */
+export const makeRpcHandlers = (config, initialData) => Effect.gen(function* () {
+    // Create the in-memory database with optional initial data
+    // biome-ignore lint/suspicious/noExplicitAny: DatasetFor type is complex and requires casting
+    const db = yield* createEffectDatabase(config, initialData);
+    // Build handlers for each collection
+    const handlers = {};
+    for (const collectionName of Object.keys(config)) {
+        handlers[collectionName] = createCollectionHandlers(collectionName, db);
+    }
+    return handlers;
+});
+/**
+ * Create an Effect Layer that provides RPC handlers for all collections.
+ *
+ * This is a convenience wrapper that combines makeRpcHandlers with makeRpcGroup
+ * to produce a complete Layer ready for use with Effect RPC server.
+ *
+ * @param config - The database configuration
+ * @param initialData - Optional initial data to seed the database
+ * @returns A Layer providing all RPC handlers
+ *
+ * @example
+ * ```typescript
+ * import { Effect } from "effect"
+ * import { makeRpcHandlersLayer } from "@proseql/rpc"
+ *
+ * const config = {
+ *   books: { schema: BookSchema, relationships: {} },
+ * } as const
+ *
+ * // Create handler layer (can be composed with other layers)
+ * const handlersLayer = makeRpcHandlersLayer(config, {
+ *   books: [{ id: "1", title: "Dune" }],
+ * })
+ * ```
+ */
+export const makeRpcHandlersLayer = (config, initialData) => {
+    const DatabaseContextTag = makeDatabaseContextTag();
+    return Layer.effect(DatabaseContextTag, Effect.gen(function* () {
+        // biome-ignore lint/suspicious/noExplicitAny: DatasetFor type is complex and requires casting
+        const db = yield* createEffectDatabase(config, initialData);
+        return { db };
+    }));
+};
+// ============================================================================
+// Database-First Handler Factory
+// ============================================================================
+/**
+ * Create RPC handlers from an existing database instance.
+ *
+ * This function accepts any EffectDatabase or EffectDatabaseWithPersistence
+ * and wires handlers to delegate to the collection methods. When the database
+ * is a persistent database (created via createPersistentEffectDatabase),
+ * mutations automatically trigger persistence as normal.
+ *
+ * This is the recommended approach for production use cases where you need:
+ * - File-based persistence with debounced writes
+ * - Control over the database lifecycle
+ * - Multiple transports (RPC, REST) sharing the same database instance
+ *
+ * @param config - The database configuration (used to enumerate collections)
+ * @param db - An existing EffectDatabase or EffectDatabaseWithPersistence instance
+ * @returns The RPC handler implementations
+ *
+ * @example
+ * ```typescript
+ * import { Effect, Layer } from "effect"
+ * import { createPersistentEffectDatabase, NodeStorageLayer, makeSerializerLayer, jsonCodec } from "@proseql/node"
+ * import { makeRpcHandlersFromDatabase } from "@proseql/rpc"
+ *
+ * const config = {
+ *   books: {
+ *     schema: BookSchema,
+ *     file: "./data/books.json", // persistence enabled
+ *     relationships: {},
+ *   },
+ * } as const
+ *
+ * const program = Effect.gen(function* () {
+ *   // Create persistent database
+ *   const db = yield* createPersistentEffectDatabase(config, { books: [] })
+ *
+ *   // Wire RPC handlers to the persistent database
+ *   const handlers = makeRpcHandlersFromDatabase(config, db)
+ *
+ *   // Mutations through RPC now trigger persistence automatically
+ *   yield* handlers.books.create({ data: { id: "1", title: "Dune" } })
+ *
+ *   // Flush to ensure data is written
+ *   await db.flush()
+ * })
+ *
+ * const PersistenceLayer = Layer.merge(
+ *   NodeStorageLayer,
+ *   makeSerializerLayer([jsonCodec()]),
+ * )
+ *
+ * await Effect.runPromise(
+ *   program.pipe(Effect.provide(PersistenceLayer), Effect.scoped),
+ * )
+ * ```
+ */
+export const makeRpcHandlersFromDatabase = (config, db) => {
+    // Build handlers for each collection, delegating to the provided database
+    const handlers = {};
+    for (const collectionName of Object.keys(config)) {
+        handlers[collectionName] = createCollectionHandlers(collectionName, db);
+    }
+    return handlers;
+};
+/**
+ * Create an Effect Layer that provides RPC handlers from an existing database.
+ *
+ * Similar to makeRpcHandlersLayer, but accepts an existing database instance
+ * instead of creating one internally. This allows you to use a persistent
+ * database with the RPC layer.
+ *
+ * @param db - An existing EffectDatabase or EffectDatabaseWithPersistence instance
+ * @returns A Layer providing all RPC handlers via DatabaseContext
+ *
+ * @example
+ * ```typescript
+ * import { Effect, Layer } from "effect"
+ * import { createPersistentEffectDatabase } from "@proseql/node"
+ * import { makeRpcHandlersLayerFromDatabase, makeDatabaseContextTag } from "@proseql/rpc"
+ *
+ * const program = Effect.gen(function* () {
+ *   const db = yield* createPersistentEffectDatabase(config, initialData)
+ *   const handlerLayer = makeRpcHandlersLayerFromDatabase(db)
+ *
+ *   // Use the layer with your RPC server
+ *   // ...
+ * })
+ * ```
+ */
+export const makeRpcHandlersLayerFromDatabase = (db) => {
+    const DatabaseContextTag = makeDatabaseContextTag();
+    return Layer.succeed(DatabaseContextTag, { db });
+};
+//# sourceMappingURL=rpc-handlers.js.map

package/dist/rpc-handlers.js.map

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