@preclaim/core 0.1.0

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> @preclaim/core@0.1.0 build /Users/paulveth/projects/preclaim/packages/core
+> tsc
+

package/dist/client.d.ts

@@ -0,0 +1,22 @@
+import type { ApiResponse, ClaimRequest, ClaimResult, BatchCheckRequest, BatchCheckResult, HeartbeatRequest, HeartbeatResult, SessionRegisterRequest, ReleaseRequest, ReleaseResult, Lock } from './types.js';
+export declare class PreclaimClient {
+    private baseUrl;
+    private accessToken;
+    private timeoutMs;
+    constructor(opts: {
+        baseUrl: string;
+        accessToken: string;
+        timeoutMs?: number;
+    });
+    private request;
+    claimFile(req: ClaimRequest): Promise<ApiResponse<ClaimResult>>;
+    releaseLocks(req: ReleaseRequest): Promise<ApiResponse<ReleaseResult>>;
+    listLocks(projectId: string): Promise<ApiResponse<Lock[]>>;
+    batchCheck(req: BatchCheckRequest): Promise<ApiResponse<BatchCheckResult>>;
+    heartbeat(req: HeartbeatRequest): Promise<ApiResponse<HeartbeatResult>>;
+    registerSession(req: SessionRegisterRequest): Promise<ApiResponse<{
+        session_id: string;
+    }>>;
+    endSession(sessionId: string): Promise<ApiResponse<ReleaseResult>>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,cAAc,EACd,aAAa,EACb,IAAI,EACL,MAAM,YAAY,CAAC;AAEpB,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;gBAEd,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;YAMhE,OAAO;IA+Bf,SAAS,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IAO/D,YAAY,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IAOtE,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;IAI1D,UAAU,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAO1E,SAAS,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;IAOvE,eAAe,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,WAAW,CAAC;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAO1F,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;CAMzE"}

package/dist/client.js

@@ -0,0 +1,78 @@
+export class PreclaimClient {
+    baseUrl;
+    accessToken;
+    timeoutMs;
+    constructor(opts) {
+        this.baseUrl = opts.baseUrl.replace(/\/$/, '');
+        this.accessToken = opts.accessToken;
+        this.timeoutMs = opts.timeoutMs ?? 5000;
+    }
+    async request(path, opts = {}) {
+        const start = Date.now();
+        const url = `${this.baseUrl}/api/v1${path}`;
+        try {
+            const res = await fetch(url, {
+                ...opts,
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${this.accessToken}`,
+                    ...opts.headers,
+                },
+                signal: AbortSignal.timeout(this.timeoutMs),
+            });
+            if (!res.ok) {
+                const body = await res.text();
+                return { error: `HTTP ${res.status}: ${body}` };
+            }
+            const data = await res.json();
+            return { data };
+        }
+        catch (err) {
+            const elapsed = Date.now() - start;
+            if (err instanceof Error && err.name === 'TimeoutError') {
+                return { error: `Request timeout after ${elapsed}ms` };
+            }
+            return { error: err instanceof Error ? err.message : 'Unknown error' };
+        }
+    }
+    async claimFile(req) {
+        return this.request('/locks', {
+            method: 'POST',
+            body: JSON.stringify(req),
+        });
+    }
+    async releaseLocks(req) {
+        return this.request('/locks', {
+            method: 'DELETE',
+            body: JSON.stringify(req),
+        });
+    }
+    async listLocks(projectId) {
+        return this.request(`/locks?project_id=${projectId}`);
+    }
+    async batchCheck(req) {
+        return this.request('/locks/check', {
+            method: 'POST',
+            body: JSON.stringify(req),
+        });
+    }
+    async heartbeat(req) {
+        return this.request('/heartbeat', {
+            method: 'POST',
+            body: JSON.stringify(req),
+        });
+    }
+    async registerSession(req) {
+        return this.request('/sessions', {
+            method: 'POST',
+            body: JSON.stringify(req),
+        });
+    }
+    async endSession(sessionId) {
+        return this.request('/sessions', {
+            method: 'DELETE',
+            body: JSON.stringify({ session_id: sessionId }),
+        });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,9 @@
+import type { PreclaimConfig, PreclaimCredentials } from './types.js';
+export declare function findConfig(startDir?: string): Promise<{
+    config: PreclaimConfig;
+    configPath: string;
+} | null>;
+export declare function getCredentialsPath(): string;
+export declare function loadCredentials(): Promise<PreclaimCredentials | null>;
+export declare function defaultConfig(projectId: string, backend: string): PreclaimConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAMtE,wBAAsB,UAAU,CAAC,QAAQ,GAAE,MAAsB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAejI;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAO3E;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAShF"}

package/dist/config.js

@@ -0,0 +1,44 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+const CONFIG_FILENAME = '.preclaim.json';
+const CREDENTIALS_DIR = '.preclaim';
+const CREDENTIALS_FILENAME = 'credentials.json';
+export async function findConfig(startDir = process.cwd()) {
+    let dir = startDir;
+    const root = '/';
+    while (dir !== root) {
+        const configPath = join(dir, CONFIG_FILENAME);
+        try {
+            const raw = await readFile(configPath, 'utf-8');
+            return { config: JSON.parse(raw), configPath };
+        }
+        catch {
+            dir = join(dir, '..');
+        }
+    }
+    return null;
+}
+export function getCredentialsPath() {
+    return join(homedir(), CREDENTIALS_DIR, CREDENTIALS_FILENAME);
+}
+export async function loadCredentials() {
+    try {
+        const raw = await readFile(getCredentialsPath(), 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+export function defaultConfig(projectId, backend) {
+    return {
+        version: 1,
+        projectId,
+        backend,
+        ttl: 30,
+        failOpen: true,
+        ignore: ['*.md', 'package-lock.json', '*.test.ts'],
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGlC,MAAM,eAAe,GAAG,gBAAgB,CAAC;AACzC,MAAM,eAAe,GAAG,WAAW,CAAC;AACpC,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AAEhD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,WAAmB,OAAO,CAAC,GAAG,EAAE;IAC/D,IAAI,GAAG,GAAG,QAAQ,CAAC;IACnB,MAAM,IAAI,GAAG,GAAG,CAAC;IAEjB,OAAO,GAAG,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAChD,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,EAAE,UAAU,EAAE,CAAC;QACnE,CAAC;QAAC,MAAM,CAAC;YACP,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,eAAe,EAAE,oBAAoB,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,kBAAkB,EAAE,EAAE,OAAO,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAwB,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,SAAiB,EAAE,OAAe;IAC9D,OAAO;QACL,OAAO,EAAE,CAAC;QACV,SAAS;QACT,OAAO;QACP,GAAG,EAAE,EAAE;QACP,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,CAAC,MAAM,EAAE,mBAAmB,EAAE,WAAW,CAAC;KACnD,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { PreclaimClient } from './client.js';
+export { findConfig, loadCredentials, getCredentialsPath, defaultConfig } from './config.js';
+export type { Organization, Profile, Project, Session, Lock, LockHolder, LockHistoryEntry, ClaimStatus, ClaimResult, ClaimRequest, BatchCheckRequest, BatchCheckResult, HeartbeatRequest, HeartbeatResult, SessionRegisterRequest, ReleaseRequest, ReleaseResult, PreclaimConfig, PreclaimCredentials, ApiResponse, HookInput, HookResult, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC7F,YAAY,EACV,YAAY,EACZ,OAAO,EACP,OAAO,EACP,OAAO,EACP,IAAI,EACJ,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,cAAc,EACd,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,SAAS,EACT,UAAU,GACX,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { PreclaimClient } from './client.js';
+export { findConfig, loadCredentials, getCredentialsPath, defaultConfig } from './config.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,132 @@
+export interface Organization {
+    id: string;
+    name: string;
+    slug: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface Profile {
+    id: string;
+    email: string;
+    name: string | null;
+    avatar_url: string | null;
+    org_id: string | null;
+    role: 'admin' | 'member';
+    created_at: string;
+}
+export interface Project {
+    id: string;
+    org_id: string;
+    name: string;
+    slug: string;
+    repo_url: string | null;
+    default_ttl: number;
+    created_at: string;
+}
+export interface Session {
+    id: string;
+    user_id: string;
+    project_id: string;
+    provider: string;
+    started_at: string;
+    last_heartbeat: string;
+    metadata: Record<string, unknown>;
+}
+export interface Lock {
+    id: string;
+    project_id: string;
+    file_path: string;
+    session_id: string;
+    user_id: string;
+    acquired_at: string;
+    expires_at: string;
+    message: string | null;
+}
+export interface LockHolder {
+    user_id: string;
+    session_id: string;
+    acquired_at: string;
+    expires_at: string;
+}
+export interface LockHistoryEntry {
+    id: string;
+    project_id: string;
+    file_path: string;
+    user_id: string;
+    session_id: string;
+    provider: string;
+    action: 'acquire' | 'release' | 'expire' | 'force_release';
+    created_at: string;
+}
+export type ClaimStatus = 'acquired' | 'already_held' | 'conflict';
+export interface ClaimResult {
+    status: ClaimStatus;
+    expires_at?: string;
+    holder?: LockHolder;
+}
+export interface ClaimRequest {
+    project_id: string;
+    file_path: string;
+    session_id: string;
+    ttl_minutes?: number;
+}
+export interface BatchCheckRequest {
+    project_id: string;
+    file_paths: string[];
+}
+export interface BatchCheckResult {
+    locks: Record<string, Lock | null>;
+}
+export interface HeartbeatRequest {
+    session_id: string;
+}
+export interface HeartbeatResult {
+    extended: number;
+}
+export interface SessionRegisterRequest {
+    session_id: string;
+    project_id: string;
+    provider?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface ReleaseRequest {
+    project_id: string;
+    file_path?: string;
+    session_id: string;
+}
+export interface ReleaseResult {
+    released: number;
+}
+export interface PreclaimConfig {
+    version: number;
+    projectId: string;
+    backend: string;
+    ttl: number;
+    failOpen: boolean;
+    ignore: string[];
+}
+export interface PreclaimCredentials {
+    accessToken: string;
+    refreshToken: string;
+    expiresAt: string;
+    user: {
+        id: string;
+        email: string;
+        orgId: string;
+    };
+}
+export interface ApiResponse<T> {
+    data?: T;
+    error?: string;
+}
+export interface HookInput {
+    session_id: string;
+    tool_name?: string;
+    tool_input?: Record<string, unknown>;
+}
+export interface HookResult {
+    permissionDecision?: 'allow' | 'deny';
+    reason?: string;
+    systemMessage?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@preclaim/core",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.8.0"
+  }
+}

package/src/client.ts

@@ -0,0 +1,102 @@
+import type {
+  ApiResponse,
+  ClaimRequest,
+  ClaimResult,
+  BatchCheckRequest,
+  BatchCheckResult,
+  HeartbeatRequest,
+  HeartbeatResult,
+  SessionRegisterRequest,
+  ReleaseRequest,
+  ReleaseResult,
+  Lock,
+} from './types.js';
+
+export class PreclaimClient {
+  private baseUrl: string;
+  private accessToken: string;
+  private timeoutMs: number;
+
+  constructor(opts: { baseUrl: string; accessToken: string; timeoutMs?: number }) {
+    this.baseUrl = opts.baseUrl.replace(/\/$/, '');
+    this.accessToken = opts.accessToken;
+    this.timeoutMs = opts.timeoutMs ?? 5000;
+  }
+
+  private async request<T>(path: string, opts: RequestInit = {}): Promise<ApiResponse<T>> {
+    const start = Date.now();
+    const url = `${this.baseUrl}/api/v1${path}`;
+
+    try {
+      const res = await fetch(url, {
+        ...opts,
+        headers: {
+          'Content-Type': 'application/json',
+          'Authorization': `Bearer ${this.accessToken}`,
+          ...opts.headers,
+        },
+        signal: AbortSignal.timeout(this.timeoutMs),
+      });
+
+      if (!res.ok) {
+        const body = await res.text();
+        return { error: `HTTP ${res.status}: ${body}` };
+      }
+
+      const data = await res.json() as T;
+      return { data };
+    } catch (err: unknown) {
+      const elapsed = Date.now() - start;
+      if (err instanceof Error && err.name === 'TimeoutError') {
+        return { error: `Request timeout after ${elapsed}ms` };
+      }
+      return { error: err instanceof Error ? err.message : 'Unknown error' };
+    }
+  }
+
+  async claimFile(req: ClaimRequest): Promise<ApiResponse<ClaimResult>> {
+    return this.request<ClaimResult>('/locks', {
+      method: 'POST',
+      body: JSON.stringify(req),
+    });
+  }
+
+  async releaseLocks(req: ReleaseRequest): Promise<ApiResponse<ReleaseResult>> {
+    return this.request<ReleaseResult>('/locks', {
+      method: 'DELETE',
+      body: JSON.stringify(req),
+    });
+  }
+
+  async listLocks(projectId: string): Promise<ApiResponse<Lock[]>> {
+    return this.request<Lock[]>(`/locks?project_id=${projectId}`);
+  }
+
+  async batchCheck(req: BatchCheckRequest): Promise<ApiResponse<BatchCheckResult>> {
+    return this.request<BatchCheckResult>('/locks/check', {
+      method: 'POST',
+      body: JSON.stringify(req),
+    });
+  }
+
+  async heartbeat(req: HeartbeatRequest): Promise<ApiResponse<HeartbeatResult>> {
+    return this.request<HeartbeatResult>('/heartbeat', {
+      method: 'POST',
+      body: JSON.stringify(req),
+    });
+  }
+
+  async registerSession(req: SessionRegisterRequest): Promise<ApiResponse<{ session_id: string }>> {
+    return this.request<{ session_id: string }>('/sessions', {
+      method: 'POST',
+      body: JSON.stringify(req),
+    });
+  }
+
+  async endSession(sessionId: string): Promise<ApiResponse<ReleaseResult>> {
+    return this.request<ReleaseResult>('/sessions', {
+      method: 'DELETE',
+      body: JSON.stringify({ session_id: sessionId }),
+    });
+  }
+}

package/src/config.ts

@@ -0,0 +1,49 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import type { PreclaimConfig, PreclaimCredentials } from './types.js';
+
+const CONFIG_FILENAME = '.preclaim.json';
+const CREDENTIALS_DIR = '.preclaim';
+const CREDENTIALS_FILENAME = 'credentials.json';
+
+export async function findConfig(startDir: string = process.cwd()): Promise<{ config: PreclaimConfig; configPath: string } | null> {
+  let dir = startDir;
+  const root = '/';
+
+  while (dir !== root) {
+    const configPath = join(dir, CONFIG_FILENAME);
+    try {
+      const raw = await readFile(configPath, 'utf-8');
+      return { config: JSON.parse(raw) as PreclaimConfig, configPath };
+    } catch {
+      dir = join(dir, '..');
+    }
+  }
+
+  return null;
+}
+
+export function getCredentialsPath(): string {
+  return join(homedir(), CREDENTIALS_DIR, CREDENTIALS_FILENAME);
+}
+
+export async function loadCredentials(): Promise<PreclaimCredentials | null> {
+  try {
+    const raw = await readFile(getCredentialsPath(), 'utf-8');
+    return JSON.parse(raw) as PreclaimCredentials;
+  } catch {
+    return null;
+  }
+}
+
+export function defaultConfig(projectId: string, backend: string): PreclaimConfig {
+  return {
+    version: 1,
+    projectId,
+    backend,
+    ttl: 30,
+    failOpen: true,
+    ignore: ['*.md', 'package-lock.json', '*.test.ts'],
+  };
+}

package/src/index.ts

@@ -0,0 +1,26 @@
+export { PreclaimClient } from './client.js';
+export { findConfig, loadCredentials, getCredentialsPath, defaultConfig } from './config.js';
+export type {
+  Organization,
+  Profile,
+  Project,
+  Session,
+  Lock,
+  LockHolder,
+  LockHistoryEntry,
+  ClaimStatus,
+  ClaimResult,
+  ClaimRequest,
+  BatchCheckRequest,
+  BatchCheckResult,
+  HeartbeatRequest,
+  HeartbeatResult,
+  SessionRegisterRequest,
+  ReleaseRequest,
+  ReleaseResult,
+  PreclaimConfig,
+  PreclaimCredentials,
+  ApiResponse,
+  HookInput,
+  HookResult,
+} from './types.js';

package/src/types.ts

@@ -0,0 +1,163 @@
+// === Organizations ===
+export interface Organization {
+  id: string;
+  name: string;
+  slug: string;
+  created_at: string;
+  updated_at: string;
+}
+
+// === Profiles ===
+export interface Profile {
+  id: string;
+  email: string;
+  name: string | null;
+  avatar_url: string | null;
+  org_id: string | null;
+  role: 'admin' | 'member';
+  created_at: string;
+}
+
+// === Projects ===
+export interface Project {
+  id: string;
+  org_id: string;
+  name: string;
+  slug: string;
+  repo_url: string | null;
+  default_ttl: number;
+  created_at: string;
+}
+
+// === Sessions ===
+export interface Session {
+  id: string;
+  user_id: string;
+  project_id: string;
+  provider: string;
+  started_at: string;
+  last_heartbeat: string;
+  metadata: Record<string, unknown>;
+}
+
+// === Locks ===
+export interface Lock {
+  id: string;
+  project_id: string;
+  file_path: string;
+  session_id: string;
+  user_id: string;
+  acquired_at: string;
+  expires_at: string;
+  message: string | null;
+}
+
+export interface LockHolder {
+  user_id: string;
+  session_id: string;
+  acquired_at: string;
+  expires_at: string;
+}
+
+// === Lock History ===
+export interface LockHistoryEntry {
+  id: string;
+  project_id: string;
+  file_path: string;
+  user_id: string;
+  session_id: string;
+  provider: string;
+  action: 'acquire' | 'release' | 'expire' | 'force_release';
+  created_at: string;
+}
+
+// === API Types ===
+export type ClaimStatus = 'acquired' | 'already_held' | 'conflict';
+
+export interface ClaimResult {
+  status: ClaimStatus;
+  expires_at?: string;
+  holder?: LockHolder;
+}
+
+export interface ClaimRequest {
+  project_id: string;
+  file_path: string;
+  session_id: string;
+  ttl_minutes?: number;
+}
+
+export interface BatchCheckRequest {
+  project_id: string;
+  file_paths: string[];
+}
+
+export interface BatchCheckResult {
+  locks: Record<string, Lock | null>;
+}
+
+export interface HeartbeatRequest {
+  session_id: string;
+}
+
+export interface HeartbeatResult {
+  extended: number;
+}
+
+export interface SessionRegisterRequest {
+  session_id: string;
+  project_id: string;
+  provider?: string;
+  metadata?: Record<string, unknown>;
+}
+
+export interface ReleaseRequest {
+  project_id: string;
+  file_path?: string;
+  session_id: string;
+}
+
+export interface ReleaseResult {
+  released: number;
+}
+
+// === Config ===
+export interface PreclaimConfig {
+  version: number;
+  projectId: string;
+  backend: string;
+  ttl: number;
+  failOpen: boolean;
+  ignore: string[];
+}
+
+// === Credentials ===
+export interface PreclaimCredentials {
+  accessToken: string;
+  refreshToken: string;
+  expiresAt: string;
+  user: {
+    id: string;
+    email: string;
+    orgId: string;
+  };
+}
+
+// === API Response Wrapper ===
+export interface ApiResponse<T> {
+  data?: T;
+  error?: string;
+}
+
+// === Hook Types ===
+export interface HookInput {
+  session_id: string;
+  tool_name?: string;
+  tool_input?: Record<string, unknown>;
+}
+
+export interface HookResult {
+  permissionDecision?: 'allow' | 'deny';
+  reason?: string;
+  systemMessage?: string;
+}

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src"]
+}