synapse-db 0.0.0-stage → 0.3.0

package/dist/migrator.d.ts

@@ -0,0 +1,24 @@
+import type { SynapseEngine } from "./engine";
+import type { SynapseDocumentInput } from "./types";
+export interface SqliteMigrationMapping<TRow = any, TData = any> {
+    readonly tableName: string;
+    readonly targetCollection: string;
+    readonly mapRow: (row: TRow) => {
+        readonly id: string;
+        readonly data: TData;
+        readonly body?: string;
+    };
+}
+export declare class SynapseMigrator {
+    private readonly engine;
+    constructor(engine: SynapseEngine);
+    /**
+     * SQLite 데이터베이스의 테이블을 읽어 마크다운 컬렉션으로 일괄 마이그레이션
+     * (SQL Injection 방어를 위한 테이블 식별자 화이트리스트 정규식 검증 포함)
+     */
+    migrateFromSqlite<TRow = any, TData = any>(sqliteDbPath: string, mappings: readonly SqliteMigrationMapping<TRow, TData>[]): Promise<Record<string, number>>;
+    /**
+     * JSON 배열 데이터를 마크다운 컬렉션으로 마이그레이션
+     */
+    migrateFromJsonArray<TItem = any, TData = any>(targetCollection: string, items: readonly TItem[], mapItem: (item: TItem) => SynapseDocumentInput<TData>): Promise<number>;
+}

package/dist/serializer.d.ts

@@ -0,0 +1,25 @@
+import type { SynapseWikilink } from "./types";
+/** 파싱된 마크다운 원시 구조 */
+export interface RawParsedMarkdown<T = Record<string, any>> {
+    readonly frontmatter: T;
+    readonly body: string;
+    readonly wikilinks: readonly SynapseWikilink[];
+}
+/**
+ * 텍스트에서 옵시디언 위키링크([[target|alias]] 또는 [[target]]) 자동 추출
+ */
+export declare function extractWikilinks(text: string, defaultCollection?: string): SynapseWikilink[];
+/**
+ * YAML Frontmatter 안전 파서 (순수 TypeScript 무손실 복원)
+ */
+export declare function parseMarkdownFile<T = Record<string, any>>(rawContent: string, defaultCollection?: string): RawParsedMarkdown<T>;
+/** YAML 단일 스칼라 및 인라인 JSON 값 무손실 파싱 */
+export declare function parseYamlScalar(val: string): any;
+/**
+ * 범용 문서를 마크다운 파일 내용으로 직렬화
+ */
+export declare function stringifyDocument(data: Record<string, any>, body?: string): string;
+/**
+ * 원자적 디스크 쓰기 (임시 파일 후 atomic rename)
+ */
+export declare function atomicWriteFile(targetPath: string, content: string): void;

package/dist/types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * 범용 마크다운 시냅스 데이터베이스 타입 규격 (Synapse-DB Type Specifications)
+ * SOLID 원칙 준수: 단일 책임 원칙(SRP)에 따른 타입 정의 분리
+ */
+/** 시냅스 위키링크 규격 ([[collection/id|alias]]) */
+export interface SynapseWikilink {
+    readonly raw: string;
+    readonly targetCollection: string;
+    readonly targetId: string;
+    readonly alias?: string;
+}
+/** 범용 시냅스 간선 (Synaptic Edge) */
+export interface SynapticEdge {
+    readonly fromNodeId: string;
+    readonly toNodeId: string;
+    readonly relation?: string;
+    readonly alias?: string;
+}
+/** 마크다운 볼트에 저장되는 범용 문서 (Synapse Document) */
+export interface SynapseDocument<TData = Record<string, any>> {
+    readonly id: string;
+    readonly collection: string;
+    readonly data: TData;
+    readonly body: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly wikilinks: readonly SynapseWikilink[];
+}
+/** 문서 생성 및 저장 입력 규격 */
+export interface SynapseDocumentInput<TData = Record<string, any>> {
+    readonly id: string;
+    readonly data: TData;
+    readonly body?: string;
+    readonly createdAt?: string;
+    readonly updatedAt?: string;
+}
+/** 쿼리 및 필터링 옵션 */
+export interface SynapseQueryOptions<TData = Record<string, any>> {
+    readonly filter?: (doc: SynapseDocument<TData>) => boolean;
+    readonly sortBy?: (a: SynapseDocument<TData>, b: SynapseDocument<TData>) => number;
+    readonly limit?: number;
+    readonly offset?: number;
+}
+/** 전문 검색(Full-text Search) 결과 */
+export interface SynapseSearchResult<TData = Record<string, any>> {
+    readonly document: SynapseDocument<TData>;
+    readonly score: number;
+    readonly matchedTerms: readonly string[];
+}
+/** 데이터베이스 환경 설정 */
+export interface SynapseDBConfig {
+    readonly vaultDir: string;
+    readonly autoWatch?: boolean;
+    readonly persistDebounceMs?: number;
+}
+/** 시냅스 데이터베이스 전체 통계 요약 */
+export interface SynapseDBStats {
+    readonly collectionsCount: number;
+    readonly totalDocuments: number;
+    readonly totalSynapses: number;
+    readonly collectionBreakdown: Record<string, number>;
+}

package/package.json

@@ -1,6 +1,44 @@
 {
   "name": "synapse-db",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.0",
+  "description": "Universal Markdown-First & In-Memory Connectome Database with Wikilink Auto-Wiring, Korean N-gram BM25 & Obsidian Canvas Exporter",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "bun build index.ts --outfile dist/index.js --target bun && tsc -p tsconfig.build.json",
+    "prepublishOnly": "bun run build",
+    "test": "bun test"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/minseokk77/synapse-kit.git",
+    "directory": "db"
+  },
+  "keywords": [
+    "markdown-db",
+    "obsidian",
+    "connectome",
+    "wikilinks",
+    "knowledge-graph",
+    "bm25",
+    "ai-native",
+    "synapse-kit",
+    "bun"
+  ],
+  "author": "Vesper",
+  "license": "MIT",
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^22.8.7",
+    "typescript": "^5.6.3"
+  }
+}