@baasix/sdk 0.1.0

package/dist/modules/schemas.cjs

@@ -0,0 +1,322 @@
+'use strict';
+
+// src/utils/sort.ts
+function normalizeSort(sort) {
+  if (!sort) return void 0;
+  if (typeof sort === "string") {
+    return sort;
+  }
+  if (Array.isArray(sort)) {
+    if (sort.length === 0) return void 0;
+    if (typeof sort[0] === "object" && "column" in sort[0]) {
+      return sort.map((s) => `${s.column}:${s.order.toLowerCase()}`).join(",");
+    }
+    return sort.map((s) => {
+      if (s.startsWith("-")) {
+        return `${s.substring(1)}:desc`;
+      }
+      if (s.includes(":")) {
+        return s;
+      }
+      return `${s}:asc`;
+    }).join(",");
+  }
+  if (typeof sort === "object") {
+    const entries = Object.entries(sort);
+    if (entries.length === 0) return void 0;
+    return entries.map(([field, direction]) => `${field}:${direction.toLowerCase()}`).join(",");
+  }
+  return void 0;
+}
+
+// src/modules/schemas.ts
+var SchemasModule = class {
+  client;
+  constructor(config) {
+    this.client = config.client;
+  }
+  /**
+   * List all schemas
+   *
+   * @example
+   * ```typescript
+   * const { data } = await baasix.schemas.find();
+   * console.log(data.map(s => s.collectionName));
+   * 
+   * // With pagination
+   * const { data } = await baasix.schemas.find({ page: 1, limit: 50 });
+   * ```
+   */
+  async find(params) {
+    const normalizedParams = params ? {
+      ...params,
+      sort: normalizeSort(params.sort)
+    } : void 0;
+    return this.client.get("/schemas", { params: normalizedParams });
+  }
+  /**
+   * Get schema for a specific collection
+   *
+   * @example
+   * ```typescript
+   * const schema = await baasix.schemas.findOne('products');
+   * console.log(schema.fields);
+   * ```
+   */
+  async findOne(collection) {
+    const response = await this.client.get(
+      `/schemas/${collection}`
+    );
+    return response.data;
+  }
+  /**
+   * Create a new collection/schema
+   *
+   * @example
+   * ```typescript
+   * await baasix.schemas.create({
+   *   collectionName: 'orders',
+   *   schema: {
+   *     name: 'Order',
+   *     timestamps: true,
+   *     paranoid: true,
+   *     fields: {
+   *       id: {
+   *         type: 'UUID',
+   *         primaryKey: true,
+   *         defaultValue: { type: 'UUIDV4' }
+   *       },
+   *       orderNumber: {
+   *         type: 'String',
+   *         allowNull: false,
+   *         unique: true
+   *       },
+   *       total: {
+   *         type: 'Decimal',
+   *         values: { precision: 10, scale: 2 },
+   *         allowNull: false,
+   *         defaultValue: 0
+   *       },
+   *       status: {
+   *         type: 'String',
+   *         allowNull: false,
+   *         defaultValue: 'pending'
+   *       },
+   *       items: {
+   *         type: 'JSONB',
+   *         allowNull: true,
+   *         defaultValue: []
+   *       }
+   *     }
+   *   }
+   * });
+   * ```
+   */
+  async create(data) {
+    const response = await this.client.post(
+      "/schemas",
+      data
+    );
+    return response.data;
+  }
+  /**
+   * Update an existing schema
+   *
+   * @example
+   * ```typescript
+   * await baasix.schemas.update('products', {
+   *   schema: {
+   *     name: 'Product',
+   *     timestamps: true,
+   *     fields: {
+   *       // Updated fields
+   *       description: { type: 'Text', allowNull: true }
+   *     }
+   *   }
+   * });
+   * ```
+   */
+  async update(collection, data) {
+    const response = await this.client.patch(
+      `/schemas/${collection}`,
+      data
+    );
+    return response.data;
+  }
+  /**
+   * Delete a schema (drops the table)
+   *
+   * @example
+   * ```typescript
+   * await baasix.schemas.delete('old_collection');
+   * ```
+   */
+  async delete(collection) {
+    await this.client.delete(`/schemas/${collection}`);
+  }
+  /**
+   * Create a relationship between collections
+   *
+   * @example
+   * ```typescript
+   * // Many-to-One (BelongsTo)
+   * await baasix.schemas.createRelationship('posts', {
+   *   type: 'M2O',
+   *   target: 'baasix_User',
+   *   name: 'author',
+   *   alias: 'posts'
+   * });
+   *
+   * // Many-to-Many
+   * await baasix.schemas.createRelationship('posts', {
+   *   type: 'M2M',
+   *   target: 'tags',
+   *   name: 'tags',
+   *   alias: 'posts'
+   * });
+   * ```
+   */
+  async createRelationship(collection, relationship) {
+    await this.client.post(
+      `/schemas/${collection}/relationships`,
+      relationship
+    );
+  }
+  /**
+   * Delete a relationship
+   *
+   * @example
+   * ```typescript
+   * await baasix.schemas.deleteRelationship('posts', 'author');
+   * ```
+   */
+  async deleteRelationship(collection, relationshipName) {
+    await this.client.delete(
+      `/schemas/${collection}/relationships/${relationshipName}`
+    );
+  }
+  /**
+   * Update a relationship
+   *
+   * @example
+   * ```typescript
+   * await baasix.schemas.updateRelationship('posts', 'author', {
+   *   alias: 'authoredPosts',
+   *   onDelete: 'CASCADE'
+   * });
+   * ```
+   */
+  async updateRelationship(collection, relationshipName, data) {
+    await this.client.patch(
+      `/schemas/${collection}/relationships/${relationshipName}`,
+      data
+    );
+  }
+  /**
+   * Create an index on a collection
+   *
+   * @example
+   * ```typescript
+   * // Unique index
+   * await baasix.schemas.createIndex('users', {
+   *   name: 'idx_users_email',
+   *   fields: ['email'],
+   *   unique: true
+   * });
+   *
+   * // Composite index
+   * await baasix.schemas.createIndex('orders', {
+   *   name: 'idx_orders_status_created',
+   *   fields: ['status', 'createdAt']
+   * });
+   * ```
+   */
+  async createIndex(collection, index) {
+    await this.client.post(`/schemas/${collection}/indexes`, index);
+  }
+  /**
+   * Delete an index
+   *
+   * @example
+   * ```typescript
+   * await baasix.schemas.deleteIndex('users', 'idx_users_email');
+   * ```
+   */
+  async deleteIndex(collection, indexName) {
+    await this.client.delete(`/schemas/${collection}/indexes/${indexName}`);
+  }
+  /**
+   * Add a field to an existing schema
+   *
+   * @example
+   * ```typescript
+   * await baasix.schemas.addField('products', 'rating', {
+   *   type: 'Decimal',
+   *   values: { precision: 3, scale: 2 },
+   *   allowNull: true,
+   *   defaultValue: 0
+   * });
+   * ```
+   */
+  async addField(collection, fieldName, fieldDefinition) {
+    const currentSchema = await this.findOne(collection);
+    const updatedFields = {
+      ...currentSchema.schema.fields,
+      [fieldName]: fieldDefinition
+    };
+    return this.update(collection, {
+      schema: {
+        ...currentSchema.schema,
+        fields: updatedFields
+      }
+    });
+  }
+  /**
+   * Remove a field from a schema
+   *
+   * @example
+   * ```typescript
+   * await baasix.schemas.removeField('products', 'deprecated_field');
+   * ```
+   */
+  async removeField(collection, fieldName) {
+    const currentSchema = await this.findOne(collection);
+    const { [fieldName]: _, ...remainingFields } = currentSchema.schema.fields;
+    return this.update(collection, {
+      schema: {
+        ...currentSchema.schema,
+        fields: remainingFields
+      }
+    });
+  }
+  /**
+   * Export all schemas as JSON
+   *
+   * @example
+   * ```typescript
+   * const schemas = await baasix.schemas.export();
+   * // Save to file for backup
+   * ```
+   */
+  async export() {
+    const response = await this.client.get(
+      "/schemas/export"
+    );
+    return response.data;
+  }
+  /**
+   * Import schemas from JSON
+   *
+   * @example
+   * ```typescript
+   * await baasix.schemas.import(savedSchemas);
+   * ```
+   */
+  async import(schemas) {
+    await this.client.post("/schemas/import", { schemas });
+  }
+};
+
+exports.SchemasModule = SchemasModule;
+//# sourceMappingURL=schemas.cjs.map
+//# sourceMappingURL=schemas.cjs.map

package/dist/modules/schemas.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/sort.ts","../../src/modules/schemas.ts"],"names":[],"mappings":"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","file":"schemas.cjs","sourcesContent":["import type { Sort, SortDirection } from \"../types\";\n\n/**\n * Normalize sort parameter to string format \"field:direction,field2:direction2\"\n * This is the format expected by the API for query string parameters.\n * \n * @example\n * ```typescript\n * normalizeSort({ name: 'asc', createdAt: 'desc' })\n * // Returns: \"name:asc,createdAt:desc\"\n * \n * normalizeSort(['-createdAt', 'name'])\n * // Returns: \"createdAt:desc,name:asc\"\n * \n * normalizeSort('name:asc')\n * // Returns: \"name:asc\"\n * ```\n */\nexport function normalizeSort(sort: Sort | undefined): string | undefined {\n  if (!sort) return undefined;\n\n  // Already a string\n  if (typeof sort === \"string\") {\n    return sort;\n  }\n\n  // Array of strings like ['-createdAt', 'name']\n  if (Array.isArray(sort)) {\n    if (sort.length === 0) return undefined;\n    \n    // Check if it's array of objects { column, order }\n    if (typeof sort[0] === \"object\" && \"column\" in sort[0]) {\n      return (sort as { column: string; order: SortDirection }[])\n        .map((s) => `${s.column}:${s.order.toLowerCase()}`)\n        .join(\",\");\n    }\n    \n    // Array of strings like ['-name', 'createdAt']\n    return (sort as string[])\n      .map((s) => {\n        if (s.startsWith(\"-\")) {\n          return `${s.substring(1)}:desc`;\n        }\n        if (s.includes(\":\")) {\n          return s;\n        }\n        return `${s}:asc`;\n      })\n      .join(\",\");\n  }\n\n  // Object like { name: 'asc', createdAt: 'desc' }\n  if (typeof sort === \"object\") {\n    const entries = Object.entries(sort as Record<string, SortDirection>);\n    if (entries.length === 0) return undefined;\n    \n    return entries\n      .map(([field, direction]) => `${field}:${direction.toLowerCase()}`)\n      .join(\",\");\n  }\n\n  return undefined;\n}\n","import type { HttpClient } from \"../client\";\nimport type {\n  IndexDefinition,\n  PaginatedResponse,\n  RelationshipDefinition,\n  SchemaDefinition,\n  SchemaInfo,\n  Sort,\n} from \"../types\";\nimport { normalizeSort } from \"../utils/sort\";\n\nexport interface SchemasModuleConfig {\n  client: HttpClient;\n}\n\n/**\n * Schemas module for managing database schemas, relationships, and indexes.\n *\n * @example\n * ```typescript\n * // Create a new collection\n * await baasix.schemas.create({\n *   collectionName: 'products',\n *   schema: {\n *     name: 'Product',\n *     timestamps: true,\n *     fields: {\n *       id: { type: 'UUID', primaryKey: true, defaultValue: { type: 'UUIDV4' } },\n *       name: { type: 'String', allowNull: false },\n *       price: { type: 'Decimal', values: { precision: 10, scale: 2 } }\n *     }\n *   }\n * });\n *\n * // Add a relationship\n * await baasix.schemas.createRelationship('products', {\n *   type: 'M2O',\n *   target: 'categories',\n *   name: 'category',\n *   alias: 'products'\n * });\n * ```\n */\nexport class SchemasModule {\n  private client: HttpClient;\n\n  constructor(config: SchemasModuleConfig) {\n    this.client = config.client;\n  }\n\n  /**\n   * List all schemas\n   *\n   * @example\n   * ```typescript\n   * const { data } = await baasix.schemas.find();\n   * console.log(data.map(s => s.collectionName));\n   * \n   * // With pagination\n   * const { data } = await baasix.schemas.find({ page: 1, limit: 50 });\n   * ```\n   */\n  async find(params?: {\n    page?: number;\n    limit?: number;\n    sort?: Sort;\n    search?: string;\n    filter?: Record<string, unknown>;\n  }): Promise<PaginatedResponse<SchemaInfo>> {\n    const normalizedParams = params ? {\n      ...params,\n      sort: normalizeSort(params.sort),\n    } : undefined;\n    return this.client.get<PaginatedResponse<SchemaInfo>>(\"/schemas\", { params: normalizedParams });\n  }\n\n  /**\n   * Get schema for a specific collection\n   *\n   * @example\n   * ```typescript\n   * const schema = await baasix.schemas.findOne('products');\n   * console.log(schema.fields);\n   * ```\n   */\n  async findOne(collection: string): Promise<SchemaInfo> {\n    const response = await this.client.get<{ data: SchemaInfo }>(\n      `/schemas/${collection}`\n    );\n    return response.data;\n  }\n\n  /**\n   * Create a new collection/schema\n   *\n   * @example\n   * ```typescript\n   * await baasix.schemas.create({\n   *   collectionName: 'orders',\n   *   schema: {\n   *     name: 'Order',\n   *     timestamps: true,\n   *     paranoid: true,\n   *     fields: {\n   *       id: {\n   *         type: 'UUID',\n   *         primaryKey: true,\n   *         defaultValue: { type: 'UUIDV4' }\n   *       },\n   *       orderNumber: {\n   *         type: 'String',\n   *         allowNull: false,\n   *         unique: true\n   *       },\n   *       total: {\n   *         type: 'Decimal',\n   *         values: { precision: 10, scale: 2 },\n   *         allowNull: false,\n   *         defaultValue: 0\n   *       },\n   *       status: {\n   *         type: 'String',\n   *         allowNull: false,\n   *         defaultValue: 'pending'\n   *       },\n   *       items: {\n   *         type: 'JSONB',\n   *         allowNull: true,\n   *         defaultValue: []\n   *       }\n   *     }\n   *   }\n   * });\n   * ```\n   */\n  async create(data: {\n    collectionName: string;\n    schema: SchemaDefinition;\n  }): Promise<SchemaInfo> {\n    const response = await this.client.post<{ data: SchemaInfo }>(\n      \"/schemas\",\n      data\n    );\n    return response.data;\n  }\n\n  /**\n   * Update an existing schema\n   *\n   * @example\n   * ```typescript\n   * await baasix.schemas.update('products', {\n   *   schema: {\n   *     name: 'Product',\n   *     timestamps: true,\n   *     fields: {\n   *       // Updated fields\n   *       description: { type: 'Text', allowNull: true }\n   *     }\n   *   }\n   * });\n   * ```\n   */\n  async update(\n    collection: string,\n    data: { schema: Partial<SchemaDefinition> }\n  ): Promise<SchemaInfo> {\n    const response = await this.client.patch<{ data: SchemaInfo }>(\n      `/schemas/${collection}`,\n      data\n    );\n    return response.data;\n  }\n\n  /**\n   * Delete a schema (drops the table)\n   *\n   * @example\n   * ```typescript\n   * await baasix.schemas.delete('old_collection');\n   * ```\n   */\n  async delete(collection: string): Promise<void> {\n    await this.client.delete(`/schemas/${collection}`);\n  }\n\n  /**\n   * Create a relationship between collections\n   *\n   * @example\n   * ```typescript\n   * // Many-to-One (BelongsTo)\n   * await baasix.schemas.createRelationship('posts', {\n   *   type: 'M2O',\n   *   target: 'baasix_User',\n   *   name: 'author',\n   *   alias: 'posts'\n   * });\n   *\n   * // Many-to-Many\n   * await baasix.schemas.createRelationship('posts', {\n   *   type: 'M2M',\n   *   target: 'tags',\n   *   name: 'tags',\n   *   alias: 'posts'\n   * });\n   * ```\n   */\n  async createRelationship(\n    collection: string,\n    relationship: RelationshipDefinition\n  ): Promise<void> {\n    await this.client.post(\n      `/schemas/${collection}/relationships`,\n      relationship\n    );\n  }\n\n  /**\n   * Delete a relationship\n   *\n   * @example\n   * ```typescript\n   * await baasix.schemas.deleteRelationship('posts', 'author');\n   * ```\n   */\n  async deleteRelationship(\n    collection: string,\n    relationshipName: string\n  ): Promise<void> {\n    await this.client.delete(\n      `/schemas/${collection}/relationships/${relationshipName}`\n    );\n  }\n\n  /**\n   * Update a relationship\n   *\n   * @example\n   * ```typescript\n   * await baasix.schemas.updateRelationship('posts', 'author', {\n   *   alias: 'authoredPosts',\n   *   onDelete: 'CASCADE'\n   * });\n   * ```\n   */\n  async updateRelationship(\n    collection: string,\n    relationshipName: string,\n    data: Partial<RelationshipDefinition>\n  ): Promise<void> {\n    await this.client.patch(\n      `/schemas/${collection}/relationships/${relationshipName}`,\n      data\n    );\n  }\n\n  /**\n   * Create an index on a collection\n   *\n   * @example\n   * ```typescript\n   * // Unique index\n   * await baasix.schemas.createIndex('users', {\n   *   name: 'idx_users_email',\n   *   fields: ['email'],\n   *   unique: true\n   * });\n   *\n   * // Composite index\n   * await baasix.schemas.createIndex('orders', {\n   *   name: 'idx_orders_status_created',\n   *   fields: ['status', 'createdAt']\n   * });\n   * ```\n   */\n  async createIndex(\n    collection: string,\n    index: IndexDefinition\n  ): Promise<void> {\n    await this.client.post(`/schemas/${collection}/indexes`, index);\n  }\n\n  /**\n   * Delete an index\n   *\n   * @example\n   * ```typescript\n   * await baasix.schemas.deleteIndex('users', 'idx_users_email');\n   * ```\n   */\n  async deleteIndex(collection: string, indexName: string): Promise<void> {\n    await this.client.delete(`/schemas/${collection}/indexes/${indexName}`);\n  }\n\n  /**\n   * Add a field to an existing schema\n   *\n   * @example\n   * ```typescript\n   * await baasix.schemas.addField('products', 'rating', {\n   *   type: 'Decimal',\n   *   values: { precision: 3, scale: 2 },\n   *   allowNull: true,\n   *   defaultValue: 0\n   * });\n   * ```\n   */\n  async addField(\n    collection: string,\n    fieldName: string,\n    fieldDefinition: SchemaDefinition[\"fields\"][string]\n  ): Promise<SchemaInfo> {\n    const currentSchema = await this.findOne(collection);\n    const updatedFields = {\n      ...currentSchema.schema.fields,\n      [fieldName]: fieldDefinition,\n    };\n\n    return this.update(collection, {\n      schema: {\n        ...currentSchema.schema,\n        fields: updatedFields,\n      },\n    });\n  }\n\n  /**\n   * Remove a field from a schema\n   *\n   * @example\n   * ```typescript\n   * await baasix.schemas.removeField('products', 'deprecated_field');\n   * ```\n   */\n  async removeField(\n    collection: string,\n    fieldName: string\n  ): Promise<SchemaInfo> {\n    const currentSchema = await this.findOne(collection);\n    const { [fieldName]: _, ...remainingFields } = currentSchema.schema.fields;\n\n    return this.update(collection, {\n      schema: {\n        ...currentSchema.schema,\n        fields: remainingFields,\n      },\n    });\n  }\n\n  /**\n   * Export all schemas as JSON\n   *\n   * @example\n   * ```typescript\n   * const schemas = await baasix.schemas.export();\n   * // Save to file for backup\n   * ```\n   */\n  async export(): Promise<SchemaInfo[]> {\n    const response = await this.client.get<{ data: SchemaInfo[] }>(\n      \"/schemas/export\"\n    );\n    return response.data;\n  }\n\n  /**\n   * Import schemas from JSON\n   *\n   * @example\n   * ```typescript\n   * await baasix.schemas.import(savedSchemas);\n   * ```\n   */\n  async import(schemas: SchemaInfo[]): Promise<void> {\n    await this.client.post(\"/schemas/import\", { schemas });\n  }\n}\n\n// Re-export types\nexport type {\n  IndexDefinition,\n  RelationshipDefinition,\n  SchemaDefinition,\n  SchemaInfo,\n};\n"]}

package/dist/modules/schemas.d.cts

@@ -0,0 +1,260 @@
+import { H as HttpClient, S as Sort, e as PaginatedResponse, l as SchemaInfo, m as SchemaDefinition, n as RelationshipDefinition, I as IndexDefinition } from '../client-VT7NckyI.cjs';
+import '../types-BdjsGANq.cjs';
+
+interface SchemasModuleConfig {
+    client: HttpClient;
+}
+/**
+ * Schemas module for managing database schemas, relationships, and indexes.
+ *
+ * @example
+ * ```typescript
+ * // Create a new collection
+ * await baasix.schemas.create({
+ *   collectionName: 'products',
+ *   schema: {
+ *     name: 'Product',
+ *     timestamps: true,
+ *     fields: {
+ *       id: { type: 'UUID', primaryKey: true, defaultValue: { type: 'UUIDV4' } },
+ *       name: { type: 'String', allowNull: false },
+ *       price: { type: 'Decimal', values: { precision: 10, scale: 2 } }
+ *     }
+ *   }
+ * });
+ *
+ * // Add a relationship
+ * await baasix.schemas.createRelationship('products', {
+ *   type: 'M2O',
+ *   target: 'categories',
+ *   name: 'category',
+ *   alias: 'products'
+ * });
+ * ```
+ */
+declare class SchemasModule {
+    private client;
+    constructor(config: SchemasModuleConfig);
+    /**
+     * List all schemas
+     *
+     * @example
+     * ```typescript
+     * const { data } = await baasix.schemas.find();
+     * console.log(data.map(s => s.collectionName));
+     *
+     * // With pagination
+     * const { data } = await baasix.schemas.find({ page: 1, limit: 50 });
+     * ```
+     */
+    find(params?: {
+        page?: number;
+        limit?: number;
+        sort?: Sort;
+        search?: string;
+        filter?: Record<string, unknown>;
+    }): Promise<PaginatedResponse<SchemaInfo>>;
+    /**
+     * Get schema for a specific collection
+     *
+     * @example
+     * ```typescript
+     * const schema = await baasix.schemas.findOne('products');
+     * console.log(schema.fields);
+     * ```
+     */
+    findOne(collection: string): Promise<SchemaInfo>;
+    /**
+     * Create a new collection/schema
+     *
+     * @example
+     * ```typescript
+     * await baasix.schemas.create({
+     *   collectionName: 'orders',
+     *   schema: {
+     *     name: 'Order',
+     *     timestamps: true,
+     *     paranoid: true,
+     *     fields: {
+     *       id: {
+     *         type: 'UUID',
+     *         primaryKey: true,
+     *         defaultValue: { type: 'UUIDV4' }
+     *       },
+     *       orderNumber: {
+     *         type: 'String',
+     *         allowNull: false,
+     *         unique: true
+     *       },
+     *       total: {
+     *         type: 'Decimal',
+     *         values: { precision: 10, scale: 2 },
+     *         allowNull: false,
+     *         defaultValue: 0
+     *       },
+     *       status: {
+     *         type: 'String',
+     *         allowNull: false,
+     *         defaultValue: 'pending'
+     *       },
+     *       items: {
+     *         type: 'JSONB',
+     *         allowNull: true,
+     *         defaultValue: []
+     *       }
+     *     }
+     *   }
+     * });
+     * ```
+     */
+    create(data: {
+        collectionName: string;
+        schema: SchemaDefinition;
+    }): Promise<SchemaInfo>;
+    /**
+     * Update an existing schema
+     *
+     * @example
+     * ```typescript
+     * await baasix.schemas.update('products', {
+     *   schema: {
+     *     name: 'Product',
+     *     timestamps: true,
+     *     fields: {
+     *       // Updated fields
+     *       description: { type: 'Text', allowNull: true }
+     *     }
+     *   }
+     * });
+     * ```
+     */
+    update(collection: string, data: {
+        schema: Partial<SchemaDefinition>;
+    }): Promise<SchemaInfo>;
+    /**
+     * Delete a schema (drops the table)
+     *
+     * @example
+     * ```typescript
+     * await baasix.schemas.delete('old_collection');
+     * ```
+     */
+    delete(collection: string): Promise<void>;
+    /**
+     * Create a relationship between collections
+     *
+     * @example
+     * ```typescript
+     * // Many-to-One (BelongsTo)
+     * await baasix.schemas.createRelationship('posts', {
+     *   type: 'M2O',
+     *   target: 'baasix_User',
+     *   name: 'author',
+     *   alias: 'posts'
+     * });
+     *
+     * // Many-to-Many
+     * await baasix.schemas.createRelationship('posts', {
+     *   type: 'M2M',
+     *   target: 'tags',
+     *   name: 'tags',
+     *   alias: 'posts'
+     * });
+     * ```
+     */
+    createRelationship(collection: string, relationship: RelationshipDefinition): Promise<void>;
+    /**
+     * Delete a relationship
+     *
+     * @example
+     * ```typescript
+     * await baasix.schemas.deleteRelationship('posts', 'author');
+     * ```
+     */
+    deleteRelationship(collection: string, relationshipName: string): Promise<void>;
+    /**
+     * Update a relationship
+     *
+     * @example
+     * ```typescript
+     * await baasix.schemas.updateRelationship('posts', 'author', {
+     *   alias: 'authoredPosts',
+     *   onDelete: 'CASCADE'
+     * });
+     * ```
+     */
+    updateRelationship(collection: string, relationshipName: string, data: Partial<RelationshipDefinition>): Promise<void>;
+    /**
+     * Create an index on a collection
+     *
+     * @example
+     * ```typescript
+     * // Unique index
+     * await baasix.schemas.createIndex('users', {
+     *   name: 'idx_users_email',
+     *   fields: ['email'],
+     *   unique: true
+     * });
+     *
+     * // Composite index
+     * await baasix.schemas.createIndex('orders', {
+     *   name: 'idx_orders_status_created',
+     *   fields: ['status', 'createdAt']
+     * });
+     * ```
+     */
+    createIndex(collection: string, index: IndexDefinition): Promise<void>;
+    /**
+     * Delete an index
+     *
+     * @example
+     * ```typescript
+     * await baasix.schemas.deleteIndex('users', 'idx_users_email');
+     * ```
+     */
+    deleteIndex(collection: string, indexName: string): Promise<void>;
+    /**
+     * Add a field to an existing schema
+     *
+     * @example
+     * ```typescript
+     * await baasix.schemas.addField('products', 'rating', {
+     *   type: 'Decimal',
+     *   values: { precision: 3, scale: 2 },
+     *   allowNull: true,
+     *   defaultValue: 0
+     * });
+     * ```
+     */
+    addField(collection: string, fieldName: string, fieldDefinition: SchemaDefinition["fields"][string]): Promise<SchemaInfo>;
+    /**
+     * Remove a field from a schema
+     *
+     * @example
+     * ```typescript
+     * await baasix.schemas.removeField('products', 'deprecated_field');
+     * ```
+     */
+    removeField(collection: string, fieldName: string): Promise<SchemaInfo>;
+    /**
+     * Export all schemas as JSON
+     *
+     * @example
+     * ```typescript
+     * const schemas = await baasix.schemas.export();
+     * // Save to file for backup
+     * ```
+     */
+    export(): Promise<SchemaInfo[]>;
+    /**
+     * Import schemas from JSON
+     *
+     * @example
+     * ```typescript
+     * await baasix.schemas.import(savedSchemas);
+     * ```
+     */
+    import(schemas: SchemaInfo[]): Promise<void>;
+}
+
+export { IndexDefinition, RelationshipDefinition, SchemaDefinition, SchemaInfo, SchemasModule, type SchemasModuleConfig };