@proseql/node 0.1.0 → 0.2.2

package/dist/convenience.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Convenience wrappers that eliminate manual codec/layer wiring.
+ *
+ * These functions infer codecs from the database config's file extensions
+ * and format overrides, so users don't need to manually select and wire codecs.
+ */
+import type { PluginError } from "@proseql/core";
+import { type DatabaseConfig, type EffectDatabaseOptions, type EffectDatabasePersistenceConfig, type FormatCodec, type GenerateDatabaseWithPersistence, type MigrationError, type SerializationError, type SerializerRegistryService, type StorageAdapterService, type StorageError, type UnsupportedFormatError, type ValidationError } from "@proseql/core";
+import { Effect, Layer, type Scope } from "effect";
+/**
+ * Build a persistence Layer from a database config.
+ *
+ * Infers codecs from file extensions and `format` overrides, combines with
+ * NodeStorageLayer. Optionally accepts extra codecs to merge in.
+ *
+ * @param config - Database configuration to infer codecs from
+ * @param options - Optional extra codecs to include alongside inferred ones
+ * @returns A Layer providing StorageAdapter + SerializerRegistry
+ */
+export declare const makeNodePersistenceLayer: <Config extends DatabaseConfig>(config: Config, options?: {
+    readonly codecs?: ReadonlyArray<FormatCodec>;
+}) => Layer.Layer<StorageAdapterService | SerializerRegistryService>;
+/**
+ * Create a persistent database with Node.js file storage — no manual layer wiring.
+ *
+ * Codecs are inferred from file extensions and `format` overrides in the config.
+ * The returned Effect only requires `Scope` (for cleanup); storage and serialization
+ * are provided internally.
+ *
+ * @param config - Database configuration (schemas, file paths, relationships, etc.)
+ * @param initialData - Optional initial data arrays per collection
+ * @param persistenceConfig - Optional persistence tuning (debounce, plugin codecs)
+ * @param options - Optional database options (plugins)
+ * @returns Effect yielding a fully wired persistent database
+ */
+export declare const createNodeDatabase: <Config extends DatabaseConfig>(config: Config, initialData?: { readonly [K in keyof Config]?: ReadonlyArray<Record<string, unknown>>; }, persistenceConfig?: EffectDatabasePersistenceConfig, options?: EffectDatabaseOptions) => Effect.Effect<GenerateDatabaseWithPersistence<Config>, MigrationError | StorageError | SerializationError | UnsupportedFormatError | ValidationError | PluginError, Scope.Scope>;
+//# sourceMappingURL=convenience.d.ts.map

package/dist/convenience.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convenience.d.ts","sourceRoot":"","sources":["../src/convenience.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAEN,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,+BAA+B,EACpC,KAAK,WAAW,EAChB,KAAK,+BAA+B,EAEpC,KAAK,cAAc,EAEnB,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,EAAE,MAAM,QAAQ,CAAC;AAGnD;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB,GAAI,MAAM,SAAS,cAAc,EACrE,QAAQ,MAAM,EACd,UAAU;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,CAAA;CAAE,KACxD,KAAK,CAAC,KAAK,CAAC,qBAAqB,GAAG,yBAAyB,CAG/D,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,SAAS,cAAc,EAC/D,QAAQ,MAAM,EACd,cAAc,EACb,QAAQ,EAAE,CAAC,IAAI,MAAM,MAAM,CAAC,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACrE,EACD,oBAAoB,+BAA+B,EACnD,UAAU,qBAAqB,KAC7B,MAAM,CAAC,MAAM,CACf,+BAA+B,CAAC,MAAM,CAAC,EACrC,cAAc,GACd,YAAY,GACZ,kBAAkB,GAClB,sBAAsB,GACtB,eAAe,GACf,WAAW,EACb,KAAK,CAAC,KAAK,CASX,CAAC"}

package/dist/convenience.js

@@ -0,0 +1,41 @@
+/**
+ * Convenience wrappers that eliminate manual codec/layer wiring.
+ *
+ * These functions infer codecs from the database config's file extensions
+ * and format overrides, so users don't need to manually select and wire codecs.
+ */
+import { createPersistentEffectDatabase, inferCodecsFromConfig, makeSerializerLayer, } from "@proseql/core";
+import { Effect, Layer } from "effect";
+import { NodeStorageLayer } from "./node-adapter-layer.js";
+/**
+ * Build a persistence Layer from a database config.
+ *
+ * Infers codecs from file extensions and `format` overrides, combines with
+ * NodeStorageLayer. Optionally accepts extra codecs to merge in.
+ *
+ * @param config - Database configuration to infer codecs from
+ * @param options - Optional extra codecs to include alongside inferred ones
+ * @returns A Layer providing StorageAdapter + SerializerRegistry
+ */
+export const makeNodePersistenceLayer = (config, options) => {
+    const codecs = options?.codecs ?? inferCodecsFromConfig(config);
+    return Layer.merge(NodeStorageLayer, makeSerializerLayer(codecs));
+};
+/**
+ * Create a persistent database with Node.js file storage — no manual layer wiring.
+ *
+ * Codecs are inferred from file extensions and `format` overrides in the config.
+ * The returned Effect only requires `Scope` (for cleanup); storage and serialization
+ * are provided internally.
+ *
+ * @param config - Database configuration (schemas, file paths, relationships, etc.)
+ * @param initialData - Optional initial data arrays per collection
+ * @param persistenceConfig - Optional persistence tuning (debounce, plugin codecs)
+ * @param options - Optional database options (plugins)
+ * @returns Effect yielding a fully wired persistent database
+ */
+export const createNodeDatabase = (config, initialData, persistenceConfig, options) => {
+    const layer = makeNodePersistenceLayer(config);
+    return createPersistentEffectDatabase(config, initialData, persistenceConfig, options).pipe(Effect.provide(layer));
+};
+//# sourceMappingURL=convenience.js.map

package/dist/convenience.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convenience.js","sourceRoot":"","sources":["../src/convenience.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACN,8BAA8B,EAM9B,qBAAqB,EAErB,mBAAmB,GAOnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,MAAM,EAAE,KAAK,EAAc,MAAM,QAAQ,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACvC,MAAc,EACd,OAA0D,EACO,EAAE;IACnE,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAChE,OAAO,KAAK,CAAC,KAAK,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;AACnE,CAAC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CACjC,MAAc,EACd,WAEC,EACD,iBAAmD,EACnD,OAA+B,EAU9B,EAAE;IACH,MAAM,KAAK,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAC/C,OAAO,8BAA8B,CACpC,MAAM,EACN,WAAW,EACX,iBAAiB,EACjB,OAAO,CACP,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/B,CAAC,CAAC"}

package/dist/index.d.ts

@@ -4,6 +4,7 @@
  * Re-exports everything from @proseql/core plus Node.js filesystem storage.
  */
 export * from "@proseql/core";
+export { createNodeDatabase, makeNodePersistenceLayer, } from "./convenience.js";
 export type { NodeAdapterConfig } from "./node-adapter-layer.js";
 export { makeNodeStorageLayer, NodeStorageLayer, } from "./node-adapter-layer.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,eAAe,CAAC;AAC9B,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,EACN,oBAAoB,EACpB,gBAAgB,GAChB,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,eAAe,CAAC;AAE9B,OAAO,EACN,kBAAkB,EAClB,wBAAwB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,EACN,oBAAoB,EACpB,gBAAgB,GAChB,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -5,6 +5,8 @@
  */
 // Re-export everything from core
 export * from "@proseql/core";
+// Convenience wrappers (config-driven, no manual layer wiring)
+export { createNodeDatabase, makeNodePersistenceLayer, } from "./convenience.js";
 // Export Node.js storage adapter
 export { makeNodeStorageLayer, NodeStorageLayer, } from "./node-adapter-layer.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,iCAAiC;AACjC,cAAc,eAAe,CAAC;AAE9B,iCAAiC;AACjC,OAAO,EACN,oBAAoB,EACpB,gBAAgB,GAChB,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,iCAAiC;AACjC,cAAc,eAAe,CAAC;AAC9B,+DAA+D;AAC/D,OAAO,EACN,kBAAkB,EAClB,wBAAwB,GACxB,MAAM,kBAAkB,CAAC;AAE1B,iCAAiC;AACjC,OAAO,EACN,oBAAoB,EACpB,gBAAgB,GAChB,MAAM,yBAAyB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proseql/node",
-  "version": "0.1.0",
+  "version": "0.2.2",
   "description": "Node.js file system adapter for ProseQL, re-exports core plus NodeStorageLayer",
   "type": "module",
   "scripts": {
@@ -48,7 +48,7 @@
   },
   "sideEffects": false,
   "dependencies": {
-    "@proseql/core": "workspace:*"
+    "@proseql/core": "^0.2.2"
   },
   "peerDependencies": {
     "effect": "^3.15.2"