@cooperarq/contracts 0.1.0

package/dist/auth.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+export declare const authUserSchema: z.ZodObject<{
+    avatar_url: z.ZodNullable<z.ZodString>;
+    created_at: z.ZodString;
+    display_name: z.ZodNullable<z.ZodString>;
+    email: z.ZodNullable<z.ZodString>;
+    id: z.ZodString;
+    is_guest: z.ZodOptional<z.ZodBoolean>;
+    role: z.ZodString;
+}, z.core.$strip>;
+export declare const credentialsSchema: z.ZodObject<{
+    email: z.ZodString;
+    password: z.ZodString;
+}, z.core.$strip>;
+export declare const registrationSchema: z.ZodObject<{
+    email: z.ZodString;
+    password: z.ZodString;
+    displayName: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AuthUser = z.infer<typeof authUserSchema>;

package/dist/auth.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+export const authUserSchema = z.object({
+    avatar_url: z.string().nullable(),
+    created_at: z.string(),
+    display_name: z.string().nullable(),
+    email: z.string().nullable(),
+    id: z.string(),
+    is_guest: z.boolean().optional(),
+    role: z.string()
+});
+export const credentialsSchema = z.object({
+    email: z.string().min(1),
+    password: z.string().min(8)
+});
+export const registrationSchema = credentialsSchema.extend({
+    displayName: z.string().max(200).optional()
+});

package/dist/conversations.d.ts

@@ -0,0 +1,69 @@
+import { z } from 'zod';
+export declare const messageRoleSchema: z.ZodEnum<{
+    user: "user";
+    assistant: "assistant";
+    system: "system";
+    tool: "tool";
+}>;
+export declare const dbMessageRowSchema: z.ZodObject<{
+    content: z.ZodString;
+    created_at: z.ZodString;
+    id: z.ZodString;
+    metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    model_used: z.ZodNullable<z.ZodString>;
+    parts: z.ZodUnknown;
+    role: z.ZodString;
+}, z.core.$strip>;
+export declare const conversationSchema: z.ZodObject<{
+    created_at: z.ZodString;
+    id: z.ZodString;
+    is_archived: z.ZodBoolean;
+    is_pinned: z.ZodBoolean;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    title: z.ZodNullable<z.ZodString>;
+    updated_at: z.ZodString;
+    user_id: z.ZodNullable<z.ZodString>;
+    workspace_id: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const createConversationInputSchema: z.ZodObject<{
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    title: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export declare const updateConversationInputSchema: z.ZodObject<{
+    is_archived: z.ZodOptional<z.ZodBoolean>;
+    is_pinned: z.ZodOptional<z.ZodBoolean>;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const guestConversationLimitErrorSchema: z.ZodObject<{
+    error: z.ZodLiteral<"guest_conversation_limit_reached">;
+    limit: z.ZodNumber;
+    message: z.ZodString;
+    used: z.ZodNumber;
+}, z.core.$strip>;
+export declare const postMessagePayloadSchema: z.ZodObject<{
+    content: z.ZodString;
+    credits_charged: z.ZodOptional<z.ZodNumber>;
+    metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    model_used: z.ZodOptional<z.ZodString>;
+    parts: z.ZodUnknown;
+    role: z.ZodString;
+    tokens_used: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const postConversationMessagesInputSchema: z.ZodObject<{
+    conversation_id: z.ZodString;
+    messages: z.ZodArray<z.ZodObject<{
+        content: z.ZodString;
+        credits_charged: z.ZodOptional<z.ZodNumber>;
+        metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        model_used: z.ZodOptional<z.ZodString>;
+        parts: z.ZodUnknown;
+        role: z.ZodString;
+        tokens_used: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Conversation = z.infer<typeof conversationSchema>;
+export type ConversationCreateInput = z.infer<typeof createConversationInputSchema>;
+export type DbMessageRow = z.infer<typeof dbMessageRowSchema>;
+export type GuestConversationLimitError = z.infer<typeof guestConversationLimitErrorSchema>;
+export type PostMessagePayload = z.infer<typeof postMessagePayloadSchema>;
+export type UpdateConversationInput = z.infer<typeof updateConversationInputSchema>;

package/dist/conversations.js

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+export const messageRoleSchema = z.enum(['user', 'assistant', 'system', 'tool']);
+export const dbMessageRowSchema = z.object({
+    content: z.string(),
+    created_at: z.string(),
+    id: z.string(),
+    metadata: z.record(z.string(), z.unknown()).nullable(),
+    model_used: z.string().nullable(),
+    parts: z.unknown(),
+    role: z.string()
+});
+export const conversationSchema = z.object({
+    created_at: z.string(),
+    id: z.string(),
+    is_archived: z.boolean(),
+    is_pinned: z.boolean(),
+    metadata: z.record(z.string(), z.unknown()).default({}),
+    title: z.string().nullable(),
+    updated_at: z.string(),
+    user_id: z.string().nullable(),
+    workspace_id: z.string().nullable()
+});
+export const createConversationInputSchema = z.object({
+    metadata: z.record(z.string(), z.unknown()).optional(),
+    title: z.string().min(1).max(200).default('New Chat')
+});
+export const updateConversationInputSchema = z
+    .object({
+    is_archived: z.boolean().optional(),
+    is_pinned: z.boolean().optional(),
+    title: z.string().max(200).optional()
+})
+    .refine((value) => Object.values(value).some((item) => item !== undefined), {
+    message: 'No supported fields to update'
+});
+export const guestConversationLimitErrorSchema = z.object({
+    error: z.literal('guest_conversation_limit_reached'),
+    limit: z.number(),
+    message: z.string(),
+    used: z.number()
+});
+export const postMessagePayloadSchema = z.object({
+    content: z.string(),
+    credits_charged: z.number().optional(),
+    metadata: z.record(z.string(), z.unknown()),
+    model_used: z.string().optional(),
+    parts: z.unknown(),
+    role: z.string(),
+    tokens_used: z.number().optional()
+});
+export const postConversationMessagesInputSchema = z.object({
+    conversation_id: z.string().min(1),
+    messages: z.array(postMessagePayloadSchema).min(1)
+});

package/dist/http.d.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+export declare const apiErrorSchema: z.ZodObject<{
+    error: z.ZodString;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ApiError = z.infer<typeof apiErrorSchema>;
+export declare function apiErrorMessage(value: unknown, fallback: string): string;

package/dist/http.js

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+export const apiErrorSchema = z.object({
+    error: z.string(),
+    message: z.string().optional()
+});
+export function apiErrorMessage(value, fallback) {
+    const parsed = apiErrorSchema.safeParse(value);
+    return parsed.success ? (parsed.data.message ?? parsed.data.error) : fallback;
+}

package/dist/workspace-files.d.ts

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+export declare const workspaceFileKindSchema: z.ZodEnum<{
+    md: "md";
+    json: "json";
+    yaml: "yaml";
+    mermaid: "mermaid";
+}>;
+export declare const workspaceFileSchema: z.ZodObject<{
+    content: z.ZodString;
+    created_at: z.ZodString;
+    id: z.ZodString;
+    kind: z.ZodEnum<{
+        md: "md";
+        json: "json";
+        yaml: "yaml";
+        mermaid: "mermaid";
+    }>;
+    path: z.ZodString;
+    updated_at: z.ZodString;
+}, z.core.$strip>;
+export declare const createWorkspaceFileInputSchema: z.ZodObject<{
+    content: z.ZodDefault<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const updateWorkspaceFileInputSchema: z.ZodObject<{
+    content: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const moveWorkspaceFolderInputSchema: z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+}, z.core.$strip>;
+export declare const deleteWorkspaceFolderInputSchema: z.ZodObject<{
+    path: z.ZodString;
+}, z.core.$strip>;
+export type WorkspaceFile = z.infer<typeof workspaceFileSchema>;

package/dist/workspace-files.js

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+export const workspaceFileKindSchema = z.enum(['md', 'json', 'yaml', 'mermaid']);
+export const workspaceFileSchema = z.object({
+    content: z.string(),
+    created_at: z.string(),
+    id: z.string(),
+    kind: workspaceFileKindSchema,
+    path: z.string(),
+    updated_at: z.string()
+});
+export const createWorkspaceFileInputSchema = z.object({
+    content: z.string().default(''),
+    path: z.string().min(1).max(200).optional()
+});
+export const updateWorkspaceFileInputSchema = z
+    .object({
+    content: z.string().optional(),
+    path: z.string().min(1).max(200).optional()
+})
+    .refine((value) => value.content !== undefined || value.path !== undefined, {
+    message: 'Nothing to update'
+});
+export const moveWorkspaceFolderInputSchema = z.object({
+    from: z.string().min(1).max(200),
+    to: z.string().min(1).max(200)
+});
+export const deleteWorkspaceFolderInputSchema = z.object({
+    path: z.string().min(1).max(200)
+});

package/dist/workspaces.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+export declare const workspaceEngineSchema: z.ZodEnum<{
+    json: "json";
+    yaml: "yaml";
+    mermaid: "mermaid";
+    markdown: "markdown";
+}>;
+export declare const createWorkspaceInputSchema: z.ZodObject<{
+    description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    document: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    engine: z.ZodDefault<z.ZodEnum<{
+        json: "json";
+        yaml: "yaml";
+        mermaid: "mermaid";
+        markdown: "markdown";
+    }>>;
+    title: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export declare const updateWorkspaceInputSchema: z.ZodObject<{
+    description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    is_starred: z.ZodOptional<z.ZodBoolean>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CreateWorkspaceInput = z.infer<typeof createWorkspaceInputSchema>;
+export type UpdateWorkspaceInput = z.infer<typeof updateWorkspaceInputSchema>;

package/dist/workspaces.js

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export const workspaceEngineSchema = z.enum(['mermaid', 'json', 'yaml', 'markdown']);
+export const createWorkspaceInputSchema = z.object({
+    description: z.string().max(2000).optional().nullable(),
+    document: z.record(z.string(), z.unknown()).optional(),
+    engine: workspaceEngineSchema.default('mermaid'),
+    title: z.string().min(1).max(200).default('Untitled Workspace')
+});
+export const updateWorkspaceInputSchema = z.object({
+    description: z.string().max(2000).optional().nullable(),
+    is_starred: z.boolean().optional(),
+    tags: z.array(z.string()).optional(),
+    title: z.string().max(200).optional()
+});

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@cooperarq/contracts",
+  "version": "0.1.0",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "zod": "^4.1.12"
+  },
+  "devDependencies": {
+    "vitest": "^3.2.4"
+  },
+  "exports": {
+    "./auth": {
+      "types": "./dist/auth.d.ts",
+      "default": "./dist/auth.js"
+    },
+    "./conversations": {
+      "types": "./dist/conversations.d.ts",
+      "default": "./dist/conversations.js"
+    },
+    "./http": {
+      "types": "./dist/http.d.ts",
+      "default": "./dist/http.js"
+    },
+    "./workspace-files": {
+      "types": "./dist/workspace-files.d.ts",
+      "default": "./dist/workspace-files.js"
+    },
+    "./workspaces": {
+      "types": "./dist/workspaces.d.ts",
+      "default": "./dist/workspaces.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.json",
+    "test": "vitest run"
+  }
+}