@hasna/recordings 0.1.36 → 0.1.37

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/recordings",
-  "version": "0.1.36",
+  "version": "0.1.37",
   "type": "module",
   "description": "Speech-to-text recording tool with MCP and CLI — records, transcribes, and optionally enhances text using AI",
   "repository": {
@@ -11,7 +11,8 @@
   "types": "dist/index.d.ts",
   "bin": {
     "recordings": "dist/cli/index.js",
-    "recordings-mcp": "dist/mcp/index.js"
+    "recordings-mcp": "dist/mcp/index.js",
+    "recordings-serve": "dist/server/index.js"
   },
   "exports": {
     ".": {
@@ -21,14 +22,21 @@
     "./storage": {
       "import": "./dist/storage.js",
       "types": "./dist/storage.d.ts"
+    },
+    "./sdk": {
+      "import": "./dist/sdk/index.js",
+      "types": "./dist/sdk/index.d.ts"
     }
   },
   "scripts": {
     "clean": "rm -rf dist",
-    "build": "bun run clean && bun run build:cli && bun run build:mcp && bun run build:lib && tsc --emitDeclarationOnly --outDir dist",
+    "build": "bun run clean && bun run build:cli && bun run build:mcp && bun run build:serve && bun run build:lib && tsc --emitDeclarationOnly --outDir dist",
     "build:cli": "bun build src/cli/index.ts --target=bun --outfile=dist/cli/index.js --external=commander --external=chalk --external=openai",
     "build:mcp": "bun build src/mcp/index.ts --target=bun --outfile=dist/mcp/index.js --external=@modelcontextprotocol/sdk --external=openai",
-    "build:lib": "bun build src/index.ts src/storage.ts --target=bun --outdir=dist --external=openai",
+    "build:serve": "bun build src/server/index.ts --target=bun --outfile=dist/server/index.js --external=@modelcontextprotocol/sdk --external=@hasna/contracts --external=openai --external=pg",
+    "build:lib": "bun build src/index.ts src/storage.ts src/sdk/index.ts --target=bun --outdir=dist --external=openai",
+    "generate:sdk": "bun run scripts/generate-sdk.ts",
+    "migrate": "bun run scripts/migrate.ts",
     "typecheck": "tsc --noEmit",
     "test": "bun test",
     "test:coverage": "bun test --coverage",
@@ -52,6 +60,7 @@
     "LICENSE"
   ],
   "dependencies": {
+    "@hasna/contracts": "0.4.1",
     "@hasna/events": "^0.1.11",
     "@modelcontextprotocol/sdk": "^1.12.1",
     "chalk": "^5.4.1",

package/scripts/generate-sdk.ts

@@ -0,0 +1,31 @@
+#!/usr/bin/env bun
+/**
+ * Generate the typed `/v1` SDK client from the serve OpenAPI document.
+ *
+ * Source of truth: src/server/openapi.ts (also served at GET /openapi.json).
+ * Output: src/sdk/v1.generated.ts — a dependency-free typed fetch client.
+ *
+ * Usage: bun run scripts/generate-sdk.ts
+ */
+import { writeFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { generateSdkFromOpenApi } from "@hasna/contracts/sdk";
+import { buildV1OpenApiDocument } from "../src/server/openapi.js";
+
+const root = join(dirname(fileURLToPath(import.meta.url)), "..");
+const spec = buildV1OpenApiDocument();
+const { code, operations, warnings } = generateSdkFromOpenApi(spec as never, {
+  className: "RecordingsV1Client",
+  apiKeyHeader: "x-api-key",
+});
+
+const header =
+  "// AUTO-GENERATED by scripts/generate-sdk.ts from src/server/openapi.ts — DO NOT EDIT BY HAND.\n" +
+  "// Regenerate: bun run scripts/generate-sdk.ts\n\n";
+const outPath = join(root, "src/sdk/v1.generated.ts");
+writeFileSync(outPath, header + code);
+
+console.log(`Wrote ${outPath}`);
+console.log(`Operations: ${operations.map((o) => o.functionName).join(", ")}`);
+if (warnings.length) console.log(`Warnings:\n  ${warnings.join("\n  ")}`);

package/scripts/migrate.ts

@@ -0,0 +1,37 @@
+#!/usr/bin/env bun
+/**
+ * Migration runner for the recordings cloud (A1 pure-remote) database.
+ *
+ * Applies the relational recordings schema and the contracts API-key store,
+ * idempotently (CREATE ... IF NOT EXISTS). NEVER drops or rewrites existing
+ * tables — safe to run against a populated DB. Shares the exact code path used
+ * by the serve process (`ensureCloudSchema`).
+ *
+ * The canonical DDL is committed under migrations/*.sql for transparency.
+ *
+ * Env: HASNA_RECORDINGS_DATABASE_URL (or RECORDINGS_DATABASE_URL / DATABASE_URL).
+ * Usage: bun run scripts/migrate.ts
+ */
+import { ensureCloudSchema, pingCloud, resolveCloudDatabaseUrl, closeCloud } from "../src/server/cloud.js";
+
+async function main() {
+  const url = resolveCloudDatabaseUrl();
+  if (!url) {
+    console.error(
+      "migrate: no database URL (HASNA_RECORDINGS_DATABASE_URL / RECORDINGS_DATABASE_URL / DATABASE_URL)",
+    );
+    process.exit(2);
+  }
+  console.log("migrate: connecting…");
+  await pingCloud();
+  console.log("migrate: applying schema (recordings tables + api_keys)…");
+  await ensureCloudSchema();
+  console.log("migrate: done");
+  await closeCloud();
+  process.exit(0);
+}
+
+main().catch((e) => {
+  console.error("migrate: failed:", (e as Error).message);
+  process.exit(1);
+});