libstorage

libstorage——存储抽象层。createStorage 工厂可根据环境（本地、S3、Supabase）返回对应的后端存储。LocalStorage、S3Storage、SupabaseStorage 均实现了存储接口。parseJsonl 与 serializeJsonl 可处理 JSONL 格式。适用于文件持久化、数据存储，以及多后端支持。

name: libstorage description: > libstorage - Storage abstraction layer. createStorage factory returns backend based on environment (local, S3, Supabase). LocalStorage, S3Storage, SupabaseStorage implement storage interface. parseJsonl and serializeJsonl handle JSONL format. Use for file persistence, data storage, and multi-backend support.

libstorage Skill

When to Use

•Persisting data to filesystem or cloud storage
•Supporting multiple storage backends
•Reading/writing JSON and JSONL files
•Building storage-agnostic applications

Key Concepts

Storage interface: Provides a common API (read, write, list, delete) for all supported storage systems.

createStorage: Factory that returns appropriate backend based on environment configuration.

JSONL support: Parse and serialize newline-delimited JSON for streaming data.

Usage Patterns

Pattern 1: Create storage instance

javascript

import { createStorage } from "@copilot-ld/libstorage";

const storage = createStorage(config);
await storage.write("data/file.json", { key: "value" });
const data = await storage.read("data/file.json");

Pattern 2: JSONL operations

javascript

import { parseJsonl, serializeJsonl } from "@copilot-ld/libstorage";

const items = parseJsonl(jsonlContent);
const output = serializeJsonl(items);

Integration

Used by all indexes and services. Backend configured via STORAGE environment.