@graypirate/tabula 1.0.0

package/dist/src/utils/yaml.js

@@ -0,0 +1,26 @@
+import YAML from "yaml";
+// HELPER - convert frontmatter to a dictionary
+function frontmatterToDict(frontmatter) {
+    const result = {
+        id: frontmatter.id,
+        name: frontmatter.name,
+    };
+    if (frontmatter.properties !== undefined) {
+        result.properties = frontmatter.properties;
+    }
+    return result;
+}
+export function renderFrontmatter(frontmatter) {
+    const dict = frontmatterToDict(frontmatter);
+    return `---\n${YAML.stringify(dict)}---\n`;
+}
+export function parseFrontmatter(markdown) {
+    if (!markdown.startsWith("---")) {
+        throw new Error("Frontmatter must start with ---");
+    }
+    const end = markdown.indexOf("\n---", 3);
+    if (end === -1) {
+        throw new Error("Frontmatter must end with ---");
+    }
+    return YAML.parse(markdown.slice(4, end));
+}

package/dist/src/workspace/index.d.ts

@@ -0,0 +1 @@
+export * from "./resolution";

package/dist/src/workspace/index.js

@@ -0,0 +1 @@
+export * from "./resolution";

package/dist/src/workspace/resolution.d.ts

@@ -0,0 +1,20 @@
+export declare class InvalidWorkspaceNameError extends Error {
+    readonly workspaceName: string;
+    readonly name = "InvalidWorkspaceNameError";
+    readonly details: {
+        allowed: string;
+    };
+    constructor(workspaceName: string);
+}
+export declare class WorkspaceNotFoundError extends Error {
+    readonly workspaceName: string;
+    readonly name = "WorkspaceNotFoundError";
+    constructor(workspaceName: string);
+}
+export declare function initializePackageStorage(): string;
+export declare function validateWorkspaceName(name: string): void;
+export declare function resolveWorkspaceDatabasePath(name: string): string;
+export declare function deleteWorkspaceFiles(name: string): boolean;
+export declare function resolveInitializedWorkspaceDatabasePath(name: string): string;
+export declare function listWorkspaceNames(): string[];
+export declare function workspaceDirectory(): string;

package/dist/src/workspace/resolution.js

@@ -0,0 +1,90 @@
+import { existsSync, mkdirSync, readdirSync, rmSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+const WorkspaceDirectoryName = ".tabula";
+const DatabaseExtension = ".sqlite";
+const WorkspaceNamePattern = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
+export class InvalidWorkspaceNameError extends Error {
+    workspaceName;
+    name = "InvalidWorkspaceNameError";
+    details = {
+        allowed: "letters, numbers, underscores, hyphens, and dots; must not start with a dot",
+    };
+    constructor(workspaceName) {
+        super(`Invalid workspace name: ${workspaceName}`);
+        this.workspaceName = workspaceName;
+    }
+}
+export class WorkspaceNotFoundError extends Error {
+    workspaceName;
+    name = "WorkspaceNotFoundError";
+    constructor(workspaceName) {
+        super(`Workspace not found: ${workspaceName}`);
+        this.workspaceName = workspaceName;
+    }
+}
+export function initializePackageStorage() {
+    const directory = workspaceDirectory();
+    mkdirSync(directory, { recursive: true });
+    return directory;
+}
+export function validateWorkspaceName(name) {
+    if (!WorkspaceNamePattern.test(name)) {
+        throw new InvalidWorkspaceNameError(name);
+    }
+}
+export function resolveWorkspaceDatabasePath(name) {
+    validateWorkspaceName(name);
+    return join(workspaceDirectory(), `${name}${DatabaseExtension}`);
+}
+export function deleteWorkspaceFiles(name) {
+    const databasePath = resolveWorkspaceDatabasePath(name);
+    if (!existsSync(databasePath)) {
+        throw new WorkspaceNotFoundError(name);
+    }
+    let deleted = false;
+    for (const path of workspaceFilePaths(databasePath)) {
+        if (!existsSync(path)) {
+            continue;
+        }
+        rmSync(path, { force: true });
+        deleted = true;
+    }
+    return deleted;
+}
+export function resolveInitializedWorkspaceDatabasePath(name) {
+    validateWorkspaceName(name);
+    initializePackageStorage();
+    return resolveWorkspaceDatabasePath(name);
+}
+export function listWorkspaceNames() {
+    let entries;
+    try {
+        entries = readdirSync(workspaceDirectory(), { withFileTypes: true });
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+            return [];
+        }
+        throw error;
+    }
+    return entries
+        .filter((entry) => entry.isFile() && entry.name.endsWith(DatabaseExtension))
+        .map((entry) => entry.name.slice(0, -DatabaseExtension.length))
+        .filter(isValidWorkspaceName)
+        .sort();
+}
+export function workspaceDirectory() {
+    return join(process.env.HOME ?? homedir(), WorkspaceDirectoryName);
+}
+function isValidWorkspaceName(name) {
+    return WorkspaceNamePattern.test(name);
+}
+function workspaceFilePaths(databasePath) {
+    return [
+        databasePath,
+        `${databasePath}-wal`,
+        `${databasePath}-shm`,
+        `${databasePath}-journal`,
+    ];
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@graypirate/tabula",
+  "version": "1.0.0",
+  "description": "Flexible object-oriented relational storage for agents",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "tabula": "dist/CLI/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json && mkdir -p dist/src/storage/db && cp src/storage/db/schema.sql dist/src/storage/db/schema.sql && chmod 755 dist/CLI/index.js",
+    "prepublishOnly": "bun run typecheck && bun test && bun run build",
+    "test": "bun test",
+    "typecheck": "bunx tsc --noEmit"
+  },
+  "engines": {
+    "bun": ">=1.3.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "yaml": "^2.9.0"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/node": "^25.9.1",
+    "typescript": "^5"
+  }
+}