@tapi-dev/sdk 0.1.7 → 0.1.8

package/dist/client.d.ts

@@ -2,7 +2,7 @@ import type { TapiClientOptions } from "./types.js";
 export declare class HttpClient {
     private readonly baseUrl;
     private readonly apiKey;
-    private readonly appId?;
+    private readonly projectId?;
     private readonly fetchImpl;
     constructor(options: TapiClientOptions);
     get<T>(path: string): Promise<T>;

package/dist/client.js

@@ -2,12 +2,12 @@ import { TapiError } from "./errors.js";
 export class HttpClient {
     baseUrl;
     apiKey;
-    appId;
+    projectId;
     fetchImpl;
     constructor(options) {
         this.baseUrl = options.baseUrl.replace(/\/+$/, "");
         this.apiKey = options.apiKey;
-        this.appId = options.appId;
+        this.projectId = options.projectId;
         this.fetchImpl = options.fetch ?? fetch;
     }
     async get(path) {
@@ -22,7 +22,7 @@ export class HttpClient {
             headers: {
                 Authorization: `Bearer ${this.apiKey}`,
                 "Content-Type": "application/json",
-                ...(this.appId ? { "X-Tapi-App": this.appId } : {}),
+                ...(this.projectId ? { "X-Tapi-Project": this.projectId } : {}),
             },
             body: body === undefined ? undefined : JSON.stringify(body),
         });

package/dist/index.d.ts

@@ -16,3 +16,4 @@ export declare class TapiClient {
 }
 export * from "./errors.js";
 export * from "./types.js";
+export * from "./workspace.js";

package/dist/index.js

@@ -24,3 +24,4 @@ export class TapiClient {
 }
 export * from "./errors.js";
 export * from "./types.js";
+export * from "./workspace.js";

package/dist/types.d.ts

@@ -2,7 +2,7 @@ export type RunStatus = "queued" | "running" | "completed" | "failed" | "cancell
 export interface TapiClientOptions {
     baseUrl: string;
     apiKey: string;
-    appId?: string;
+    projectId?: string;
     fetch?: typeof fetch;
     localControlUrl?: string;
     webSocket?: LocalWebSocketConstructor;

package/dist/workspace.d.ts

@@ -0,0 +1,35 @@
+export declare const TAPI_WORKSPACE_DIR = ".tapi";
+export declare const TAPI_WORKSPACE_CONFIG = "project.json";
+export interface TapiGeneratedConfig {
+    catalog?: string;
+    typescript?: string;
+    [key: string]: unknown;
+}
+export interface TapiWorkspaceConfig {
+    version: 1;
+    projectId: string;
+    projectSlug?: string;
+    apiBaseUrl?: string;
+    generated?: TapiGeneratedConfig;
+    [key: string]: unknown;
+}
+export interface TapiWorkspace {
+    root: string;
+    configPath: string;
+    config: TapiWorkspaceConfig;
+    projectId: string;
+    projectSlug?: string;
+    apiBaseUrl?: string;
+}
+export interface WriteWorkspaceConfigOptions {
+    root?: string;
+    projectId: string;
+    projectSlug?: string;
+    apiBaseUrl?: string;
+    force?: boolean;
+}
+export declare function findWorkspaceConfigPath(startDir?: string): string | undefined;
+export declare function loadWorkspace(startDir?: string): TapiWorkspace | undefined;
+export declare function readWorkspaceConfig(configPath: string): TapiWorkspaceConfig;
+export declare function writeWorkspaceConfig(options: WriteWorkspaceConfigOptions): Promise<TapiWorkspace>;
+export declare function normalizeProjectValue(value: unknown, fieldName?: string): string;

package/dist/workspace.js

@@ -0,0 +1,117 @@
+import { existsSync, readFileSync } from "node:fs";
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+export const TAPI_WORKSPACE_DIR = ".tapi";
+export const TAPI_WORKSPACE_CONFIG = "project.json";
+export function findWorkspaceConfigPath(startDir = process.cwd()) {
+    let current = resolve(startDir);
+    while (true) {
+        const candidate = join(current, TAPI_WORKSPACE_DIR, TAPI_WORKSPACE_CONFIG);
+        if (existsSync(candidate)) {
+            return candidate;
+        }
+        const parent = dirname(current);
+        if (parent === current) {
+            return undefined;
+        }
+        current = parent;
+    }
+}
+export function loadWorkspace(startDir = process.cwd()) {
+    const configPath = findWorkspaceConfigPath(startDir);
+    if (!configPath) {
+        return undefined;
+    }
+    const config = readWorkspaceConfig(configPath);
+    const root = dirname(dirname(configPath));
+    return {
+        root,
+        configPath,
+        config,
+        projectId: config.projectId,
+        projectSlug: config.projectSlug,
+        apiBaseUrl: config.apiBaseUrl,
+    };
+}
+export function readWorkspaceConfig(configPath) {
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(configPath, "utf8"));
+    }
+    catch (error) {
+        throw new Error(`Could not read Tapi workspace config at ${configPath}: ${formatError(error)}`);
+    }
+    if (!isRecord(parsed)) {
+        throw new Error(`Tapi workspace config at ${configPath} must be a JSON object.`);
+    }
+    const version = parsed.version;
+    if (version !== 1) {
+        throw new Error(`Tapi workspace config at ${configPath} has unsupported version '${String(version)}'.`);
+    }
+    const projectId = normalizeProjectValue(parsed.projectId, "projectId");
+    const projectSlug = optionalProjectValue(parsed.projectSlug, "projectSlug");
+    const apiBaseUrl = typeof parsed.apiBaseUrl === "string" && parsed.apiBaseUrl.trim() ? parsed.apiBaseUrl.trim() : undefined;
+    const generated = isRecord(parsed.generated) ? { ...parsed.generated } : undefined;
+    return {
+        ...parsed,
+        version: 1,
+        projectId,
+        ...(projectSlug ? { projectSlug } : {}),
+        ...(apiBaseUrl ? { apiBaseUrl } : {}),
+        ...(generated ? { generated } : {}),
+    };
+}
+export async function writeWorkspaceConfig(options) {
+    const root = resolve(options.root ?? process.cwd());
+    const projectId = normalizeProjectValue(options.projectId, "projectId");
+    const projectSlug = optionalProjectValue(options.projectSlug, "projectSlug") ?? projectId;
+    const configPath = join(root, TAPI_WORKSPACE_DIR, TAPI_WORKSPACE_CONFIG);
+    if (!options.force && existsSync(configPath)) {
+        throw new Error(`Tapi workspace config already exists at ${configPath}. Use --force to overwrite.`);
+    }
+    const config = {
+        version: 1,
+        projectId,
+        projectSlug,
+        ...(options.apiBaseUrl ? { apiBaseUrl: options.apiBaseUrl } : {}),
+        generated: {
+            catalog: ".tapi/generated/catalog.json",
+            typescript: "src/tapi.generated.ts",
+        },
+    };
+    await mkdir(dirname(configPath), { recursive: true });
+    await writeFile(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+    return {
+        root,
+        configPath,
+        config,
+        projectId,
+        projectSlug,
+        apiBaseUrl: config.apiBaseUrl,
+    };
+}
+export function normalizeProjectValue(value, fieldName = "project") {
+    if (typeof value !== "string") {
+        throw new Error(`Tapi ${fieldName} must be a string.`);
+    }
+    const project = value.trim();
+    if (!project) {
+        throw new Error(`Tapi ${fieldName} is required.`);
+    }
+    if (project.includes("/") || project.includes("\\") || project.includes("..")) {
+        throw new Error(`Tapi ${fieldName} is invalid.`);
+    }
+    return project;
+}
+function optionalProjectValue(value, fieldName) {
+    if (value === undefined || value === null || value === "") {
+        return undefined;
+    }
+    return normalizeProjectValue(value, fieldName);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function formatError(error) {
+    return error instanceof Error ? error.message : String(error);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tapi-dev/sdk",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -21,7 +21,7 @@
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "test": "vitest run",
+    "test": "vitest run --no-file-parallelism --testTimeout=30000",
     "prepack": "npm run build",
     "prepublishOnly": "npm test && npm run build"
   },
@@ -31,6 +31,7 @@
   "devDependencies": {
     "@types/node": "^20.0.0",
     "typescript": "^5.5.0",
-    "vitest": "^2.0.0"
+    "vite": "6.4.3",
+    "vitest": "^4.1.8"
   }
 }