data-access

@alneas/data-access

English | 日本語

レコードのCRUD、リソースサービス、DBアダプターを提供するMITの独立Publicパッケージです。 このリポジトリが正本で、React・storage・data-engineへの依存はありません。 実行時の必須依存はなく、必要なDBのSDKだけをoptional peerとして利用します。

npm install @alneas/data-access

import { createResourceService } from '@alneas/data-access';
import { SQLiteDataAccessAdapter } from '@alneas/data-access/sqlite';
import type { SqliteDriver } from '@alneas/data-access/sqlite';

export function records(driver: SqliteDriver) {
  const adapter = new SQLiteDataAccessAdapter({ driver });
  return createResourceService<{ id: string; title: string }>(adapter, 'records');
}

テーブルの作成・接続・driverはアプリ側で用意します。ルートは共通APIのみです。 /sqlite・/d1・/supabase・/supabase-graphql・/mongodb・/convex・/neon・ Oracle SQL・Duality View・ORDS・SQL FunctionはPrivateのプレミアム機能です。 動作環境はアダプターごとに異なり、Oracle直接接続にはサーバー環境とSDKが必要です。

仕様・利用条件・制約 を先に確認してください。 TypeScriptの共通型は、各DBの機能が同一であることや入力検証・認可を保証しません。 グラフ計算はtask-graph、AI共通処理・提案レビューはai-core、 グラフを使うエージェント実行・スキーマ連携はengine、ファイル保管はuniversal-storage、 案件固有のメタデータはprivate app-coreが担当します。

APIの詳細はsrcのJSDoc、開発・テストはCONTRIBUTING.md、 npm公開はRELEASING.md を参照してください。 統合サイトはALNEAS Docsです。

AI利用ガイドは配布物の dist/ai/SKILL.md と package-context.json に同梱します。次のコマンドはプロジェクトの指示ファイルへの追記をプレビューします。確認後に --write を付けると既存の指示を保持して反映します。

node node_modules/@alneas/data-access/dist/ai/setup.mjs --project .