@decocms/bindings 0.1.2 → 0.1.3

package/dist/{chunk-IBOJHI67.js → chunk-L7E6ONLJ.js}

@@ -9,30 +9,27 @@ var BaseCollectionEntitySchema = z.object({
   created_by: z.string().optional(),
   updated_by: z.string().optional()
 });
-var WhereExpressionSchema = z.lazy(
-  () => z.union([
-    // Simple comparison
-    z.object({
-      field: z.array(z.string()),
-      operator: z.enum([
-        "eq",
-        "gt",
-        "gte",
-        "lt",
-        "lte",
-        "in",
-        "like",
-        "contains"
-      ]),
-      value: z.unknown()
-    }),
-    // Logical operators
-    z.object({
-      operator: z.enum(["and", "or", "not"]),
-      conditions: z.array(WhereExpressionSchema)
-    })
-  ])
-);
+var ComparisonExpressionSchema = z.object({
+  field: z.array(z.string()),
+  operator: z.enum([
+    "eq",
+    "gt",
+    "gte",
+    "lt",
+    "lte",
+    "in",
+    "like",
+    "contains"
+  ]),
+  value: z.unknown()
+});
+var WhereExpressionSchema = z.union([
+  ComparisonExpressionSchema,
+  z.object({
+    operator: z.enum(["and", "or", "not"]),
+    conditions: z.array(ComparisonExpressionSchema)
+  })
+]);
 var OrderByExpressionSchema = z.object({
   field: z.array(z.string()),
   direction: z.enum(["asc", "desc"]),
@@ -128,5 +125,5 @@ function createCollectionBindings(collectionName, entitySchema, options) {
 }
 
 export { BaseCollectionEntitySchema, CollectionDeleteInputSchema, CollectionDeleteOutputSchema, CollectionGetInputSchema, CollectionListInputSchema, OrderByExpressionSchema, WhereExpressionSchema, createCollectionBindings, createCollectionGetOutputSchema, createCollectionInsertInputSchema, createCollectionInsertOutputSchema, createCollectionListOutputSchema, createCollectionUpdateInputSchema, createCollectionUpdateOutputSchema };
-//# sourceMappingURL=chunk-IBOJHI67.js.map
-//# sourceMappingURL=chunk-IBOJHI67.js.map
+//# sourceMappingURL=chunk-L7E6ONLJ.js.map
+//# sourceMappingURL=chunk-L7E6ONLJ.js.map

package/dist/chunk-L7E6ONLJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/well-known/collections.ts"],"names":[],"mappings":"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","file":"chunk-L7E6ONLJ.js","sourcesContent":["import { z } from \"zod\";\nimport type { ToolBinder } from \"../core/binder\";\n\n/**\n * Collection Bindings\n *\n * This module provides standardized tool bindings for Collections, representing\n * SQL table-like structures with CRUD + Search operations compatible with TanStack DB.\n *\n * Key Features:\n * - Generic collection bindings that work with any entity type\n * - Standardized tool naming: `DECO_COLLECTION_{COLLECTION}_*`\n * - Compatible with TanStack DB query-collection\n * - Full TypeScript support with proper type constraints\n * - Support for filtering, sorting, and pagination\n * - Simple id and title fields for human-readable identification\n */\n\n/**\n * Base schema for collection entities\n * All collection entities must have an id, title, and audit trail fields\n */\nexport const BaseCollectionEntitySchema = z.object({\n  id: z.string().describe(\"Unique identifier for the entity\"),\n  title: z.string().describe(\"Human-readable title for the entity\"),\n  created_at: z.string().datetime(),\n  updated_at: z.string().datetime(),\n  created_by: z.string().optional(),\n  updated_by: z.string().optional(),\n});\n\n/**\n * Type helper for BaseCollectionEntitySchema\n */\nexport type BaseCollectionEntitySchemaType = typeof BaseCollectionEntitySchema;\n\n/**\n * Comparison expression schema for filtering\n */\nconst ComparisonExpressionSchema = z.object({\n  field: z.array(z.string()),\n  operator: z.enum([\n    \"eq\",\n    \"gt\",\n    \"gte\",\n    \"lt\",\n    \"lte\",\n    \"in\",\n    \"like\",\n    \"contains\",\n  ]),\n  value: z.unknown(),\n});\n\n/**\n * Where expression schema for filtering\n * Supports TanStack DB predicate push-down patterns\n */\nexport const WhereExpressionSchema = z.union([\n  ComparisonExpressionSchema,\n  z.object({\n    operator: z.enum([\"and\", \"or\", \"not\"]),\n    conditions: z.array(ComparisonExpressionSchema),\n  }),\n]);\n\n/**\n * Where expression type for filtering\n * Derived from WhereExpressionSchema\n */\nexport type WhereExpression = z.infer<typeof WhereExpressionSchema>;\n\n/**\n * Order by expression for sorting\n */\nexport const OrderByExpressionSchema = z.object({\n  field: z.array(z.string()),\n  direction: z.enum([\"asc\", \"desc\"]),\n  nulls: z.enum([\"first\", \"last\"]).optional(),\n});\n\n/**\n * List/Query input schema for collections\n * Compatible with TanStack DB LoadSubsetOptions\n */\nexport const CollectionListInputSchema = z.object({\n  where: WhereExpressionSchema.optional().describe(\"Filter expression\"),\n  orderBy: z\n    .array(OrderByExpressionSchema)\n    .optional()\n    .describe(\"Sort expressions\"),\n  limit: z\n    .number()\n    .int()\n    .min(1)\n    .max(1000)\n    .optional()\n    .describe(\"Maximum number of items to return\"),\n  offset: z\n    .number()\n    .int()\n    .min(0)\n    .optional()\n    .describe(\"Number of items to skip\"),\n});\n\n/**\n * Factory function to create list output schema for a specific collection type\n */\nexport function createCollectionListOutputSchema<T extends z.ZodTypeAny>(\n  entitySchema: T,\n) {\n  return z.object({\n    items: z.array(entitySchema).describe(\"Array of collection items\"),\n    totalCount: z\n      .number()\n      .int()\n      .min(0)\n      .optional()\n      .describe(\"Total number of matching items (if available)\"),\n    hasMore: z\n      .boolean()\n      .optional()\n      .describe(\"Whether there are more items available\"),\n  });\n}\n\n/**\n * Get by ID input schema\n */\nexport const CollectionGetInputSchema = z.object({\n  id: z.string().describe(\"ID of the entity to retrieve\"),\n});\n\n/**\n * Factory function to create get output schema\n */\nexport function createCollectionGetOutputSchema<T extends z.ZodTypeAny>(\n  entitySchema: T,\n) {\n  return z.object({\n    item: entitySchema\n      .nullable()\n      .describe(\"The retrieved item, or null if not found\"),\n  });\n}\n\n/**\n * Factory function to create insert input schema\n */\nexport function createCollectionInsertInputSchema<T extends z.ZodTypeAny>(\n  entitySchema: T,\n) {\n  // Remove id field since it may be auto-generated by the server\n  return z.object({\n    data: entitySchema.describe(\"Data for the new entity (id may be auto-generated)\"),\n  });\n}\n\n/**\n * Factory function to create insert output schema\n */\nexport function createCollectionInsertOutputSchema<T extends z.ZodTypeAny>(\n  entitySchema: T,\n) {\n  return z.object({\n    item: entitySchema.describe(\"The created entity with generated id\"),\n  });\n}\n\n/**\n * Factory function to create update input schema\n */\nexport function createCollectionUpdateInputSchema<T extends z.ZodTypeAny>(\n  entitySchema: T,\n) {\n  return z.object({\n    id: z.string().describe(\"ID of the entity to update\"),\n    data: (entitySchema as unknown as z.AnyZodObject)\n      .partial()\n      .describe(\"Partial entity data to update\"),\n  });\n}\n\n/**\n * Factory function to create update output schema\n */\nexport function createCollectionUpdateOutputSchema<T extends z.ZodTypeAny>(\n  entitySchema: T,\n) {\n  return z.object({\n    item: entitySchema.describe(\"The updated entity\"),\n  });\n}\n\n/**\n * Delete input schema\n */\nexport const CollectionDeleteInputSchema = z.object({\n  id: z.string().describe(\"ID of the entity to delete\"),\n});\n\n/**\n * Delete output schema\n */\nexport const CollectionDeleteOutputSchema = z.object({\n  success: z.boolean().describe(\"Whether the deletion was successful\"),\n  id: z.string().describe(\"ID of the deleted entity\"),\n});\n\n/**\n * Options for creating collection bindings\n */\nexport interface CollectionBindingOptions {\n  /**\n   * If true, only LIST and GET operations will be included (read-only collection)\n   * @default false\n   */\n  readOnly?: boolean;\n}\n\n/**\n * Creates generic collection bindings for a specific entity type\n *\n * This function generates standardized tool bindings that work with any collection/table\n * by accepting a custom entity schema and collection name. The bindings provide:\n * - DECO_COLLECTION_{NAME}_LIST - Query/search entities with filtering and sorting (required)\n * - DECO_COLLECTION_{NAME}_GET - Get a single entity by ID (required)\n * - DECO_COLLECTION_{NAME}_INSERT - Create a new entity (optional, excluded if readOnly=true)\n * - DECO_COLLECTION_{NAME}_UPDATE - Update an existing entity (optional, excluded if readOnly=true)\n * - DECO_COLLECTION_{NAME}_DELETE - Delete an entity (optional, excluded if readOnly=true)\n *\n * @param collectionName - The name of the collection/table (e.g., \"users\", \"products\", \"orders\")\n * @param entitySchema - The Zod schema for the entity type (must extend BaseCollectionEntitySchema)\n * @param options - Optional configuration for the collection bindings\n * @returns Array of tool bindings for Collection CRUD + Query operations\n *\n * @example\n * ```typescript\n * const UserSchema = z.object({\n *   id: z.string(),\n *   title: z.string(),\n *   created_at: z.string().datetime(),\n *   updated_at: z.string().datetime(),\n *   created_by: z.string().optional(),\n *   updated_by: z.string().optional(),\n *   email: z.string().email(),\n * });\n *\n * // Full CRUD collection\n * const USER_COLLECTION_BINDING = createCollectionBindings(\"users\", UserSchema);\n *\n * // Read-only collection (only LIST and GET)\n * const READONLY_COLLECTION_BINDING = createCollectionBindings(\"products\", ProductSchema, { readOnly: true });\n * ```\n */\nexport function createCollectionBindings<\n  TEntitySchema extends BaseCollectionEntitySchemaType,\n>(\n  collectionName: string,\n  entitySchema: TEntitySchema,\n  options?: CollectionBindingOptions,\n) {\n  const upperName = collectionName.toUpperCase();\n  const readOnly = options?.readOnly ?? false;\n\n  const bindings: ToolBinder[] = [\n    {\n      name: `DECO_COLLECTION_${upperName}_LIST` as const,\n      inputSchema: CollectionListInputSchema,\n      outputSchema: createCollectionListOutputSchema(entitySchema),\n    },\n    {\n      name: `DECO_COLLECTION_${upperName}_GET` as const,\n      inputSchema: CollectionGetInputSchema,\n      outputSchema: createCollectionGetOutputSchema(entitySchema),\n    },\n  ];\n\n  // Only include mutation operations if not read-only\n  if (!readOnly) {\n    bindings.push(\n      {\n        name: `DECO_COLLECTION_${upperName}_INSERT` as const,\n        inputSchema: createCollectionInsertInputSchema(entitySchema),\n        outputSchema: createCollectionInsertOutputSchema(entitySchema),\n        opt: true,\n      },\n      {\n        name: `DECO_COLLECTION_${upperName}_UPDATE` as const,\n        inputSchema: createCollectionUpdateInputSchema(entitySchema),\n        outputSchema: createCollectionUpdateOutputSchema(entitySchema),\n        opt: true,\n      },\n      {\n        name: `DECO_COLLECTION_${upperName}_DELETE` as const,\n        inputSchema: CollectionDeleteInputSchema,\n        outputSchema: CollectionDeleteOutputSchema,\n        opt: true,\n      },\n    );\n  }\n\n  return bindings satisfies readonly ToolBinder[];\n}\n\n/**\n * Type helper to extract the collection binding type\n */\nexport type CollectionBinding<\n  TEntitySchema extends BaseCollectionEntitySchemaType,\n> = ReturnType<typeof createCollectionBindings<TEntitySchema>>;\n\n/**\n * Type helper to extract tool names from a collection binding\n */\nexport type CollectionTools<\n  TEntitySchema extends BaseCollectionEntitySchemaType,\n> = CollectionBinding<TEntitySchema>[number][\"name\"];\n\n// Export types for TypeScript usage\nexport type CollectionListInput = z.infer<typeof CollectionListInputSchema>;\nexport type CollectionGetInput = z.infer<typeof CollectionGetInputSchema>;\nexport type CollectionDeleteInput = z.infer<typeof CollectionDeleteInputSchema>;\nexport type CollectionDeleteOutput = z.infer<\n  typeof CollectionDeleteOutputSchema\n>;\nexport type OrderByExpression = z.infer<typeof OrderByExpressionSchema>;\n"]}

package/dist/index.js

@@ -36,6 +36,7 @@ function createBindingChecker(binderTools) {
         }
         const binderInputSchema = normalizeSchema(binderTool.inputSchema);
         const toolInputSchema = normalizeSchema(matchedTool.inputSchema);
+        console.log(JSON.stringify(binderInputSchema, null, 2));
         if (binderInputSchema && toolInputSchema) {
           try {
             const inputDiff = await diffSchemas({
@@ -46,6 +47,7 @@ function createBindingChecker(binderTools) {
               return false;
             }
           } catch (error) {
+            console.error("Schema diff failed", error);
             return false;
           }
         } else if (binderInputSchema && !toolInputSchema) {
@@ -63,6 +65,7 @@ function createBindingChecker(binderTools) {
               return false;
             }
           } catch (error) {
+            console.error("Schema diff failed", error);
             return false;
           }
         } else if (binderOutputSchema && !toolOutputSchema) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/binder.ts"],"names":["jsonSchema"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Core Binder Types and Utilities\n *\n * This module provides the core types and utilities for the bindings system.\n * Bindings define standardized interfaces that integrations (MCPs) can implement.\n */\n\nimport type { ZodType } from \"zod\";\nimport { zodToJsonSchema } from \"zod-to-json-schema\";\nimport { diffSchemas } from \"json-schema-diff\";\n\n/**\n * ToolBinder defines a single tool within a binding.\n * It specifies the tool name, input/output schemas, and whether it's optional.\n *\n * @template TName - The tool name (can be a string or RegExp for pattern matching)\n * @template TInput - The input type (inferred from inputSchema)\n * @template TReturn - The return type (inferred from outputSchema)\n */\nexport interface ToolBinder<\n  TName extends string | RegExp = string,\n  // biome-ignore lint/suspicious/noExplicitAny: Generic type parameter\n  TInput = any,\n  TReturn extends object | null | boolean = object,\n> {\n  /** The name of the tool (e.g., \"DECO_CHAT_CHANNELS_JOIN\") */\n  name: TName;\n\n  /** Zod schema for validating tool input */\n  inputSchema: ZodType<TInput>;\n\n  /** Optional Zod schema for validating tool output */\n  outputSchema?: ZodType<TReturn>;\n\n  /**\n   * Whether this tool is optional in the binding.\n   * If true, an implementation doesn't need to provide this tool.\n   */\n  opt?: true;\n}\n\n/**\n * Binder represents a collection of tool definitions that form a binding.\n * A binding is like a TypeScript interface - it defines what tools must be implemented.\n *\n * @template TDefinition - Array of ToolBinder definitions\n *\n * @example\n * ```ts\n * const MY_BINDING = [{\n *   name: \"MY_TOOL\" as const,\n *   inputSchema: z.object({ id: z.string() }),\n *   outputSchema: z.object({ success: z.boolean() }),\n * }] as const satisfies Binder;\n * ```\n */\nexport type Binder<\n  TDefinition extends readonly ToolBinder[] = readonly ToolBinder[],\n> = TDefinition;\n\n/**\n * Tool with schemas for validation\n */\nexport interface ToolWithSchemas {\n  name: string;\n  inputSchema?: ZodType<any> | Record<string, unknown>;\n  outputSchema?: ZodType<any> | Record<string, unknown>;\n}\n\n/**\n * Converts a schema to JSON Schema format if it's a Zod schema\n */\nfunction normalizeSchema(schema: any): Record<string, unknown> | undefined {\n  if (!schema) return undefined;\n\n  // If it's a Zod schema (has _def property), convert it\n  if (schema._def) {\n    const jsonSchema = zodToJsonSchema(schema, {\n      // Don't add additionalProperties: false to allow structural compatibility\n      $refStrategy: \"none\",\n    }) as Record<string, unknown>;\n\n    // Remove additionalProperties constraint to allow subtyping\n    if (jsonSchema.type === \"object\") {\n      delete jsonSchema.additionalProperties;\n    }\n\n    return jsonSchema;\n  }\n\n  // Otherwise assume it's already a JSON Schema\n  const jsonSchema = schema as Record<string, unknown>;\n\n  // Remove additionalProperties constraint if present\n  if (jsonSchema.type === \"object\" && \"additionalProperties\" in jsonSchema) {\n    const copy = { ...jsonSchema };\n    delete copy.additionalProperties;\n    return copy;\n  }\n\n  return jsonSchema;\n}\n\n/**\n * Binding checker interface\n */\nexport interface BindingChecker {\n  /**\n   * Check if a set of tools implements the binding with full schema validation.\n   *\n   * Validates:\n   * - Tool name matches (exact or regex)\n   * - Input schema: Tool accepts what binder requires (no removals from binder to tool)\n   * - Output schema: Tool provides what binder expects (no removals from tool to binder)\n   *\n   * @param tools - Array of tools with names and schemas\n   * @returns Promise<boolean> - true if all tools implement the binding correctly\n   */\n  isImplementedBy: (tools: ToolWithSchemas[]) => Promise<boolean>;\n}\n\n/**\n * Creates a binding checker with full schema validation using json-schema-diff.\n *\n * This performs strict compatibility checking:\n * - For input schemas: Validates that the tool can accept what the binder requires\n * - For output schemas: Validates that the tool provides what the binder expects\n *\n * @param binderTools - The binding definition to check against\n * @returns A binding checker with an async isImplementedBy method\n *\n * @example\n * ```ts\n * const checker = createBindingChecker(MY_BINDING);\n * const isCompatible = await checker.isImplementedBy(availableTools);\n * ```\n */\nexport function createBindingChecker<TDefinition extends readonly ToolBinder[]>(\n  binderTools: TDefinition,\n): BindingChecker {\n  return {\n    isImplementedBy: async (tools: ToolWithSchemas[]) => {\n      for (const binderTool of binderTools) {\n        // Find matching tool by name (exact or regex)\n        const pattern =\n          typeof binderTool.name === \"string\"\n            ? new RegExp(`^${binderTool.name}$`)\n            : binderTool.name;\n\n        const matchedTool = tools.find((t) => pattern.test(t.name));\n\n        // Skip optional tools that aren't present\n        if (!matchedTool && binderTool.opt) {\n          continue;\n        }\n\n        // Required tool not found\n        if (!matchedTool) {\n          return false;\n        }\n\n        // === INPUT SCHEMA VALIDATION ===\n        // Tool must accept what binder requires\n        // Check: binder (source) -> tool (destination)\n        // If removals found, tool doesn't accept something binder requires\n        const binderInputSchema = normalizeSchema(binderTool.inputSchema);\n        const toolInputSchema = normalizeSchema(matchedTool.inputSchema);\n\n        if (binderInputSchema && toolInputSchema) {\n          try {\n            const inputDiff = await diffSchemas({\n              sourceSchema: binderInputSchema,\n              destinationSchema: toolInputSchema,\n            });\n\n            // If something was removed from binder to tool, tool can't accept it\n            if (inputDiff.removalsFound) {\n              return false;\n            }\n          } catch (error) {\n            // Schema diff failed - consider incompatible\n            return false;\n          }\n        } else if (binderInputSchema && !toolInputSchema) {\n          // Binder requires input schema but tool doesn't have one\n          return false;\n        }\n\n        // === OUTPUT SCHEMA VALIDATION ===\n        // Tool must provide what binder expects (but can provide more)\n        // Check: binder (source) -> tool (destination)\n        // If removals found, tool doesn't provide something binder expects\n        const binderOutputSchema = normalizeSchema(binderTool.outputSchema);\n        const toolOutputSchema = normalizeSchema(matchedTool.outputSchema);\n\n        if (binderOutputSchema && toolOutputSchema) {\n          try {\n            const outputDiff = await diffSchemas({\n              sourceSchema: binderOutputSchema,\n              destinationSchema: toolOutputSchema,\n            });\n\n            // If something was removed from binder to tool, tool doesn't provide it\n            if (outputDiff.removalsFound) {\n              return false;\n            }\n          } catch (error) {\n            // Schema diff failed - consider incompatible\n            return false;\n          }\n        } else if (binderOutputSchema && !toolOutputSchema) {\n          // Binder expects output schema but tool doesn't have one\n          return false;\n        }\n      }\n\n      return true;\n    },\n  };\n}\n\n"]}
+{"version":3,"sources":["../src/core/binder.ts"],"names":["jsonSchema"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Core Binder Types and Utilities\n *\n * This module provides the core types and utilities for the bindings system.\n * Bindings define standardized interfaces that integrations (MCPs) can implement.\n */\n\nimport type { ZodType } from \"zod\";\nimport { zodToJsonSchema } from \"zod-to-json-schema\";\nimport { diffSchemas } from \"json-schema-diff\";\n\n/**\n * ToolBinder defines a single tool within a binding.\n * It specifies the tool name, input/output schemas, and whether it's optional.\n *\n * @template TName - The tool name (can be a string or RegExp for pattern matching)\n * @template TInput - The input type (inferred from inputSchema)\n * @template TReturn - The return type (inferred from outputSchema)\n */\nexport interface ToolBinder<\n  TName extends string | RegExp = string,\n  // biome-ignore lint/suspicious/noExplicitAny: Generic type parameter\n  TInput = any,\n  TReturn extends object | null | boolean = object,\n> {\n  /** The name of the tool (e.g., \"DECO_CHAT_CHANNELS_JOIN\") */\n  name: TName;\n\n  /** Zod schema for validating tool input */\n  inputSchema: ZodType<TInput>;\n\n  /** Optional Zod schema for validating tool output */\n  outputSchema?: ZodType<TReturn>;\n\n  /**\n   * Whether this tool is optional in the binding.\n   * If true, an implementation doesn't need to provide this tool.\n   */\n  opt?: true;\n}\n\n/**\n * Binder represents a collection of tool definitions that form a binding.\n * A binding is like a TypeScript interface - it defines what tools must be implemented.\n *\n * @template TDefinition - Array of ToolBinder definitions\n *\n * @example\n * ```ts\n * const MY_BINDING = [{\n *   name: \"MY_TOOL\" as const,\n *   inputSchema: z.object({ id: z.string() }),\n *   outputSchema: z.object({ success: z.boolean() }),\n * }] as const satisfies Binder;\n * ```\n */\nexport type Binder<\n  TDefinition extends readonly ToolBinder[] = readonly ToolBinder[],\n> = TDefinition;\n\n/**\n * Tool with schemas for validation\n */\nexport interface ToolWithSchemas {\n  name: string;\n  inputSchema?: ZodType<any> | Record<string, unknown>;\n  outputSchema?: ZodType<any> | Record<string, unknown>;\n}\n\n/**\n * Converts a schema to JSON Schema format if it's a Zod schema\n */\nfunction normalizeSchema(schema: any): Record<string, unknown> | undefined {\n  if (!schema) return undefined;\n\n  // If it's a Zod schema (has _def property), convert it\n  if (schema._def) {\n    const jsonSchema = zodToJsonSchema(schema, {\n      // Don't add additionalProperties: false to allow structural compatibility\n      $refStrategy: \"none\",\n    }) as Record<string, unknown>;\n\n    // Remove additionalProperties constraint to allow subtyping\n    if (jsonSchema.type === \"object\") {\n      delete jsonSchema.additionalProperties;\n    }\n\n    return jsonSchema;\n  }\n\n  // Otherwise assume it's already a JSON Schema\n  const jsonSchema = schema as Record<string, unknown>;\n\n  // Remove additionalProperties constraint if present\n  if (jsonSchema.type === \"object\" && \"additionalProperties\" in jsonSchema) {\n    const copy = { ...jsonSchema };\n    delete copy.additionalProperties;\n    return copy;\n  }\n\n  return jsonSchema;\n}\n\n/**\n * Binding checker interface\n */\nexport interface BindingChecker {\n  /**\n   * Check if a set of tools implements the binding with full schema validation.\n   *\n   * Validates:\n   * - Tool name matches (exact or regex)\n   * - Input schema: Tool accepts what binder requires (no removals from binder to tool)\n   * - Output schema: Tool provides what binder expects (no removals from tool to binder)\n   *\n   * @param tools - Array of tools with names and schemas\n   * @returns Promise<boolean> - true if all tools implement the binding correctly\n   */\n  isImplementedBy: (tools: ToolWithSchemas[]) => Promise<boolean>;\n}\n\n/**\n * Creates a binding checker with full schema validation using json-schema-diff.\n *\n * This performs strict compatibility checking:\n * - For input schemas: Validates that the tool can accept what the binder requires\n * - For output schemas: Validates that the tool provides what the binder expects\n *\n * @param binderTools - The binding definition to check against\n * @returns A binding checker with an async isImplementedBy method\n *\n * @example\n * ```ts\n * const checker = createBindingChecker(MY_BINDING);\n * const isCompatible = await checker.isImplementedBy(availableTools);\n * ```\n */\nexport function createBindingChecker<TDefinition extends readonly ToolBinder[]>(\n  binderTools: TDefinition,\n): BindingChecker {\n  return {\n    isImplementedBy: async (tools: ToolWithSchemas[]) => {\n      for (const binderTool of binderTools) {\n        // Find matching tool by name (exact or regex)\n        const pattern = typeof binderTool.name === \"string\"\n          ? new RegExp(`^${binderTool.name}$`)\n          : binderTool.name;\n\n        const matchedTool = tools.find((t) => pattern.test(t.name));\n\n        // Skip optional tools that aren't present\n        if (!matchedTool && binderTool.opt) {\n          continue;\n        }\n\n        // Required tool not found\n        if (!matchedTool) {\n          return false;\n        }\n\n        // === INPUT SCHEMA VALIDATION ===\n        // Tool must accept what binder requires\n        // Check: binder (source) -> tool (destination)\n        // If removals found, tool doesn't accept something binder requires\n        const binderInputSchema = normalizeSchema(binderTool.inputSchema);\n        const toolInputSchema = normalizeSchema(matchedTool.inputSchema);\n\n        console.log(JSON.stringify(binderInputSchema, null, 2));\n\n        if (binderInputSchema && toolInputSchema) {\n          try {\n            const inputDiff = await diffSchemas({\n              sourceSchema: binderInputSchema,\n              destinationSchema: toolInputSchema,\n            });\n\n            // If something was removed from binder to tool, tool can't accept it\n            if (inputDiff.removalsFound) {\n              return false;\n            }\n          } catch (error) {\n            console.error(\"Schema diff failed\", error);\n            // Schema diff failed - consider incompatible\n            return false;\n          }\n        } else if (binderInputSchema && !toolInputSchema) {\n          // Binder requires input schema but tool doesn't have one\n          return false;\n        }\n\n        // === OUTPUT SCHEMA VALIDATION ===\n        // Tool must provide what binder expects (but can provide more)\n        // Check: binder (source) -> tool (destination)\n        // If removals found, tool doesn't provide something binder expects\n        const binderOutputSchema = normalizeSchema(binderTool.outputSchema);\n        const toolOutputSchema = normalizeSchema(matchedTool.outputSchema);\n\n        if (binderOutputSchema && toolOutputSchema) {\n          try {\n            const outputDiff = await diffSchemas({\n              sourceSchema: binderOutputSchema,\n              destinationSchema: toolOutputSchema,\n            });\n\n            // If something was removed from binder to tool, tool doesn't provide it\n            if (outputDiff.removalsFound) {\n              return false;\n            }\n          } catch (error) {\n            console.error(\"Schema diff failed\", error);\n            // Schema diff failed - consider incompatible\n            return false;\n          }\n        } else if (binderOutputSchema && !toolOutputSchema) {\n          // Binder expects output schema but tool doesn't have one\n          return false;\n        }\n      }\n\n      return true;\n    },\n  };\n}\n"]}

package/dist/well-known/collections.d.ts

@@ -46,22 +46,56 @@ declare const BaseCollectionEntitySchema: z.ZodObject<{
  */
 type BaseCollectionEntitySchemaType = typeof BaseCollectionEntitySchema;
 /**
- * Where expression type for filtering
+ * Where expression schema for filtering
  * Supports TanStack DB predicate push-down patterns
  */
-type WhereExpression = {
+declare const WhereExpressionSchema: z.ZodUnion<[z.ZodObject<{
+    field: z.ZodArray<z.ZodString, "many">;
+    operator: z.ZodEnum<["eq", "gt", "gte", "lt", "lte", "in", "like", "contains"]>;
+    value: z.ZodUnknown;
+}, "strip", z.ZodTypeAny, {
     field: string[];
     operator: "eq" | "gt" | "gte" | "lt" | "lte" | "in" | "like" | "contains";
-    value: unknown;
-} | {
+    value?: unknown;
+}, {
+    field: string[];
+    operator: "eq" | "gt" | "gte" | "lt" | "lte" | "in" | "like" | "contains";
+    value?: unknown;
+}>, z.ZodObject<{
+    operator: z.ZodEnum<["and", "or", "not"]>;
+    conditions: z.ZodArray<z.ZodObject<{
+        field: z.ZodArray<z.ZodString, "many">;
+        operator: z.ZodEnum<["eq", "gt", "gte", "lt", "lte", "in", "like", "contains"]>;
+        value: z.ZodUnknown;
+    }, "strip", z.ZodTypeAny, {
+        field: string[];
+        operator: "eq" | "gt" | "gte" | "lt" | "lte" | "in" | "like" | "contains";
+        value?: unknown;
+    }, {
+        field: string[];
+        operator: "eq" | "gt" | "gte" | "lt" | "lte" | "in" | "like" | "contains";
+        value?: unknown;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
     operator: "and" | "or" | "not";
-    conditions: WhereExpression[];
-};
+    conditions: {
+        field: string[];
+        operator: "eq" | "gt" | "gte" | "lt" | "lte" | "in" | "like" | "contains";
+        value?: unknown;
+    }[];
+}, {
+    operator: "and" | "or" | "not";
+    conditions: {
+        field: string[];
+        operator: "eq" | "gt" | "gte" | "lt" | "lte" | "in" | "like" | "contains";
+        value?: unknown;
+    }[];
+}>]>;
 /**
- * Where expression schema for filtering
- * Supports TanStack DB predicate push-down patterns
+ * Where expression type for filtering
+ * Derived from WhereExpressionSchema
  */
-declare const WhereExpressionSchema: z.ZodType<WhereExpression>;
+type WhereExpression = z.infer<typeof WhereExpressionSchema>;
 /**
  * Order by expression for sorting
  */
@@ -83,7 +117,48 @@ declare const OrderByExpressionSchema: z.ZodObject<{
  * Compatible with TanStack DB LoadSubsetOptions
  */
 declare const CollectionListInputSchema: z.ZodObject<{
-    where: z.ZodOptional<z.ZodType<WhereExpression, z.ZodTypeDef, WhereExpression>>;
+    where: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+        field: z.ZodArray<z.ZodString, "many">;
+        operator: z.ZodEnum<["eq", "gt", "gte", "lt", "lte", "in", "like", "contains"]>;
+        value: z.ZodUnknown;
+    }, "strip", z.ZodTypeAny, {
+        field: string[];
+        operator: "eq" | "gt" | "gte" | "lt" | "lte" | "in" | "like" | "contains";
+        value?: unknown;
+    }, {
+        field: string[];
+        operator: "eq" | "gt" | "gte" | "lt" | "lte" | "in" | "like" | "contains";
+        value?: unknown;
+    }>, z.ZodObject<{
+        operator: z.ZodEnum<["and", "or", "not"]>;
+        conditions: z.ZodArray<z.ZodObject<{
+            field: z.ZodArray<z.ZodString, "many">;
+            operator: z.ZodEnum<["eq", "gt", "gte", "lt", "lte", "in", "like", "contains"]>;
+            value: z.ZodUnknown;
+        }, "strip", z.ZodTypeAny, {
+            field: string[];
+            operator: "eq" | "gt" | "gte" | "lt" | "lte" | "in" | "like" | "contains";
+            value?: unknown;
+        }, {
+            field: string[];
+            operator: "eq" | "gt" | "gte" | "lt" | "lte" | "in" | "like" | "contains";
+            value?: unknown;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        operator: "and" | "or" | "not";
+        conditions: {
+            field: string[];
+            operator: "eq" | "gt" | "gte" | "lt" | "lte" | "in" | "like" | "contains";
+            value?: unknown;
+        }[];
+    }, {
+        operator: "and" | "or" | "not";
+        conditions: {
+            field: string[];
+            operator: "eq" | "gt" | "gte" | "lt" | "lte" | "in" | "like" | "contains";
+            value?: unknown;
+        }[];
+    }>]>>;
     orderBy: z.ZodOptional<z.ZodArray<z.ZodObject<{
         field: z.ZodArray<z.ZodString, "many">;
         direction: z.ZodEnum<["asc", "desc"]>;
@@ -100,7 +175,18 @@ declare const CollectionListInputSchema: z.ZodObject<{
     limit: z.ZodOptional<z.ZodNumber>;
     offset: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    where?: WhereExpression | undefined;
+    where?: {
+        field: string[];
+        operator: "eq" | "gt" | "gte" | "lt" | "lte" | "in" | "like" | "contains";
+        value?: unknown;
+    } | {
+        operator: "and" | "or" | "not";
+        conditions: {
+            field: string[];
+            operator: "eq" | "gt" | "gte" | "lt" | "lte" | "in" | "like" | "contains";
+            value?: unknown;
+        }[];
+    } | undefined;
     orderBy?: {
         field: string[];
         direction: "asc" | "desc";
@@ -109,7 +195,18 @@ declare const CollectionListInputSchema: z.ZodObject<{
     limit?: number | undefined;
     offset?: number | undefined;
 }, {
-    where?: WhereExpression | undefined;
+    where?: {
+        field: string[];
+        operator: "eq" | "gt" | "gte" | "lt" | "lte" | "in" | "like" | "contains";
+        value?: unknown;
+    } | {
+        operator: "and" | "or" | "not";
+        conditions: {
+            field: string[];
+            operator: "eq" | "gt" | "gte" | "lt" | "lte" | "in" | "like" | "contains";
+            value?: unknown;
+        }[];
+    } | undefined;
     orderBy?: {
         field: string[];
         direction: "asc" | "desc";

package/dist/well-known/collections.js

@@ -1,3 +1,3 @@
-export { BaseCollectionEntitySchema, CollectionDeleteInputSchema, CollectionDeleteOutputSchema, CollectionGetInputSchema, CollectionListInputSchema, OrderByExpressionSchema, WhereExpressionSchema, createCollectionBindings, createCollectionGetOutputSchema, createCollectionInsertInputSchema, createCollectionInsertOutputSchema, createCollectionListOutputSchema, createCollectionUpdateInputSchema, createCollectionUpdateOutputSchema } from '../chunk-IBOJHI67.js';
+export { BaseCollectionEntitySchema, CollectionDeleteInputSchema, CollectionDeleteOutputSchema, CollectionGetInputSchema, CollectionListInputSchema, OrderByExpressionSchema, WhereExpressionSchema, createCollectionBindings, createCollectionGetOutputSchema, createCollectionInsertInputSchema, createCollectionInsertOutputSchema, createCollectionListOutputSchema, createCollectionUpdateInputSchema, createCollectionUpdateOutputSchema } from '../chunk-L7E6ONLJ.js';
 //# sourceMappingURL=collections.js.map
 //# sourceMappingURL=collections.js.map

package/dist/well-known/models.js

@@ -1,4 +1,4 @@
-import { BaseCollectionEntitySchema, createCollectionBindings } from '../chunk-IBOJHI67.js';
+import { BaseCollectionEntitySchema, createCollectionBindings } from '../chunk-L7E6ONLJ.js';
 import { z } from 'zod';
 
 var ModelSchema = BaseCollectionEntitySchema.extend({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decocms/bindings",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "type": "module",
   "scripts": {
     "build": "tsup",

package/src/core/binder.ts

@@ -142,10 +142,9 @@ export function createBindingChecker<TDefinition extends readonly ToolBinder[]>(
     isImplementedBy: async (tools: ToolWithSchemas[]) => {
       for (const binderTool of binderTools) {
         // Find matching tool by name (exact or regex)
-        const pattern =
-          typeof binderTool.name === "string"
-            ? new RegExp(`^${binderTool.name}$`)
-            : binderTool.name;
+        const pattern = typeof binderTool.name === "string"
+          ? new RegExp(`^${binderTool.name}$`)
+          : binderTool.name;
 
         const matchedTool = tools.find((t) => pattern.test(t.name));
 
@@ -166,6 +165,8 @@ export function createBindingChecker<TDefinition extends readonly ToolBinder[]>(
         const binderInputSchema = normalizeSchema(binderTool.inputSchema);
         const toolInputSchema = normalizeSchema(matchedTool.inputSchema);
 
+        console.log(JSON.stringify(binderInputSchema, null, 2));
+
         if (binderInputSchema && toolInputSchema) {
           try {
             const inputDiff = await diffSchemas({
@@ -178,6 +179,7 @@ export function createBindingChecker<TDefinition extends readonly ToolBinder[]>(
               return false;
             }
           } catch (error) {
+            console.error("Schema diff failed", error);
             // Schema diff failed - consider incompatible
             return false;
           }
@@ -205,6 +207,7 @@ export function createBindingChecker<TDefinition extends readonly ToolBinder[]>(
               return false;
             }
           } catch (error) {
+            console.error("Schema diff failed", error);
             // Schema diff failed - consider incompatible
             return false;
           }
@@ -218,4 +221,3 @@ export function createBindingChecker<TDefinition extends readonly ToolBinder[]>(
     },
   };
 }
-

package/src/well-known/collections.ts

@@ -35,48 +35,40 @@ export const BaseCollectionEntitySchema = z.object({
 export type BaseCollectionEntitySchemaType = typeof BaseCollectionEntitySchema;
 
 /**
- * Where expression type for filtering
- * Supports TanStack DB predicate push-down patterns
+ * Comparison expression schema for filtering
  */
-export type WhereExpression =
-  | {
-    field: string[];
-    operator: "eq" | "gt" | "gte" | "lt" | "lte" | "in" | "like" | "contains";
-    value: unknown;
-  }
-  | {
-    operator: "and" | "or" | "not";
-    conditions: WhereExpression[];
-  };
+const ComparisonExpressionSchema = z.object({
+  field: z.array(z.string()),
+  operator: z.enum([
+    "eq",
+    "gt",
+    "gte",
+    "lt",
+    "lte",
+    "in",
+    "like",
+    "contains",
+  ]),
+  value: z.unknown(),
+});
 
 /**
  * Where expression schema for filtering
  * Supports TanStack DB predicate push-down patterns
  */
-export const WhereExpressionSchema = z.lazy(() =>
-  z.union([
-    // Simple comparison
-    z.object({
-      field: z.array(z.string()),
-      operator: z.enum([
-        "eq",
-        "gt",
-        "gte",
-        "lt",
-        "lte",
-        "in",
-        "like",
-        "contains",
-      ]),
-      value: z.unknown(),
-    }),
-    // Logical operators
-    z.object({
-      operator: z.enum(["and", "or", "not"]),
-      conditions: z.array(WhereExpressionSchema),
-    }),
-  ])
-) as z.ZodType<WhereExpression>;
+export const WhereExpressionSchema = z.union([
+  ComparisonExpressionSchema,
+  z.object({
+    operator: z.enum(["and", "or", "not"]),
+    conditions: z.array(ComparisonExpressionSchema),
+  }),
+]);
+
+/**
+ * Where expression type for filtering
+ * Derived from WhereExpressionSchema
+ */
+export type WhereExpression = z.infer<typeof WhereExpressionSchema>;
 
 /**
  * Order by expression for sorting

package/dist/chunk-IBOJHI67.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/well-known/collections.ts"],"names":[],"mappings":"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","file":"chunk-IBOJHI67.js","sourcesContent":["import { z } from \"zod\";\nimport type { ToolBinder } from \"../core/binder\";\n\n/**\n * Collection Bindings\n *\n * This module provides standardized tool bindings for Collections, representing\n * SQL table-like structures with CRUD + Search operations compatible with TanStack DB.\n *\n * Key Features:\n * - Generic collection bindings that work with any entity type\n * - Standardized tool naming: `DECO_COLLECTION_{COLLECTION}_*`\n * - Compatible with TanStack DB query-collection\n * - Full TypeScript support with proper type constraints\n * - Support for filtering, sorting, and pagination\n * - Simple id and title fields for human-readable identification\n */\n\n/**\n * Base schema for collection entities\n * All collection entities must have an id, title, and audit trail fields\n */\nexport const BaseCollectionEntitySchema = z.object({\n  id: z.string().describe(\"Unique identifier for the entity\"),\n  title: z.string().describe(\"Human-readable title for the entity\"),\n  created_at: z.string().datetime(),\n  updated_at: z.string().datetime(),\n  created_by: z.string().optional(),\n  updated_by: z.string().optional(),\n});\n\n/**\n * Type helper for BaseCollectionEntitySchema\n */\nexport type BaseCollectionEntitySchemaType = typeof BaseCollectionEntitySchema;\n\n/**\n * Where expression type for filtering\n * Supports TanStack DB predicate push-down patterns\n */\nexport type WhereExpression =\n  | {\n    field: string[];\n    operator: \"eq\" | \"gt\" | \"gte\" | \"lt\" | \"lte\" | \"in\" | \"like\" | \"contains\";\n    value: unknown;\n  }\n  | {\n    operator: \"and\" | \"or\" | \"not\";\n    conditions: WhereExpression[];\n  };\n\n/**\n * Where expression schema for filtering\n * Supports TanStack DB predicate push-down patterns\n */\nexport const WhereExpressionSchema = z.lazy(() =>\n  z.union([\n    // Simple comparison\n    z.object({\n      field: z.array(z.string()),\n      operator: z.enum([\n        \"eq\",\n        \"gt\",\n        \"gte\",\n        \"lt\",\n        \"lte\",\n        \"in\",\n        \"like\",\n        \"contains\",\n      ]),\n      value: z.unknown(),\n    }),\n    // Logical operators\n    z.object({\n      operator: z.enum([\"and\", \"or\", \"not\"]),\n      conditions: z.array(WhereExpressionSchema),\n    }),\n  ])\n) as z.ZodType<WhereExpression>;\n\n/**\n * Order by expression for sorting\n */\nexport const OrderByExpressionSchema = z.object({\n  field: z.array(z.string()),\n  direction: z.enum([\"asc\", \"desc\"]),\n  nulls: z.enum([\"first\", \"last\"]).optional(),\n});\n\n/**\n * List/Query input schema for collections\n * Compatible with TanStack DB LoadSubsetOptions\n */\nexport const CollectionListInputSchema = z.object({\n  where: WhereExpressionSchema.optional().describe(\"Filter expression\"),\n  orderBy: z\n    .array(OrderByExpressionSchema)\n    .optional()\n    .describe(\"Sort expressions\"),\n  limit: z\n    .number()\n    .int()\n    .min(1)\n    .max(1000)\n    .optional()\n    .describe(\"Maximum number of items to return\"),\n  offset: z\n    .number()\n    .int()\n    .min(0)\n    .optional()\n    .describe(\"Number of items to skip\"),\n});\n\n/**\n * Factory function to create list output schema for a specific collection type\n */\nexport function createCollectionListOutputSchema<T extends z.ZodTypeAny>(\n  entitySchema: T,\n) {\n  return z.object({\n    items: z.array(entitySchema).describe(\"Array of collection items\"),\n    totalCount: z\n      .number()\n      .int()\n      .min(0)\n      .optional()\n      .describe(\"Total number of matching items (if available)\"),\n    hasMore: z\n      .boolean()\n      .optional()\n      .describe(\"Whether there are more items available\"),\n  });\n}\n\n/**\n * Get by ID input schema\n */\nexport const CollectionGetInputSchema = z.object({\n  id: z.string().describe(\"ID of the entity to retrieve\"),\n});\n\n/**\n * Factory function to create get output schema\n */\nexport function createCollectionGetOutputSchema<T extends z.ZodTypeAny>(\n  entitySchema: T,\n) {\n  return z.object({\n    item: entitySchema\n      .nullable()\n      .describe(\"The retrieved item, or null if not found\"),\n  });\n}\n\n/**\n * Factory function to create insert input schema\n */\nexport function createCollectionInsertInputSchema<T extends z.ZodTypeAny>(\n  entitySchema: T,\n) {\n  // Remove id field since it may be auto-generated by the server\n  return z.object({\n    data: entitySchema.describe(\"Data for the new entity (id may be auto-generated)\"),\n  });\n}\n\n/**\n * Factory function to create insert output schema\n */\nexport function createCollectionInsertOutputSchema<T extends z.ZodTypeAny>(\n  entitySchema: T,\n) {\n  return z.object({\n    item: entitySchema.describe(\"The created entity with generated id\"),\n  });\n}\n\n/**\n * Factory function to create update input schema\n */\nexport function createCollectionUpdateInputSchema<T extends z.ZodTypeAny>(\n  entitySchema: T,\n) {\n  return z.object({\n    id: z.string().describe(\"ID of the entity to update\"),\n    data: (entitySchema as unknown as z.AnyZodObject)\n      .partial()\n      .describe(\"Partial entity data to update\"),\n  });\n}\n\n/**\n * Factory function to create update output schema\n */\nexport function createCollectionUpdateOutputSchema<T extends z.ZodTypeAny>(\n  entitySchema: T,\n) {\n  return z.object({\n    item: entitySchema.describe(\"The updated entity\"),\n  });\n}\n\n/**\n * Delete input schema\n */\nexport const CollectionDeleteInputSchema = z.object({\n  id: z.string().describe(\"ID of the entity to delete\"),\n});\n\n/**\n * Delete output schema\n */\nexport const CollectionDeleteOutputSchema = z.object({\n  success: z.boolean().describe(\"Whether the deletion was successful\"),\n  id: z.string().describe(\"ID of the deleted entity\"),\n});\n\n/**\n * Options for creating collection bindings\n */\nexport interface CollectionBindingOptions {\n  /**\n   * If true, only LIST and GET operations will be included (read-only collection)\n   * @default false\n   */\n  readOnly?: boolean;\n}\n\n/**\n * Creates generic collection bindings for a specific entity type\n *\n * This function generates standardized tool bindings that work with any collection/table\n * by accepting a custom entity schema and collection name. The bindings provide:\n * - DECO_COLLECTION_{NAME}_LIST - Query/search entities with filtering and sorting (required)\n * - DECO_COLLECTION_{NAME}_GET - Get a single entity by ID (required)\n * - DECO_COLLECTION_{NAME}_INSERT - Create a new entity (optional, excluded if readOnly=true)\n * - DECO_COLLECTION_{NAME}_UPDATE - Update an existing entity (optional, excluded if readOnly=true)\n * - DECO_COLLECTION_{NAME}_DELETE - Delete an entity (optional, excluded if readOnly=true)\n *\n * @param collectionName - The name of the collection/table (e.g., \"users\", \"products\", \"orders\")\n * @param entitySchema - The Zod schema for the entity type (must extend BaseCollectionEntitySchema)\n * @param options - Optional configuration for the collection bindings\n * @returns Array of tool bindings for Collection CRUD + Query operations\n *\n * @example\n * ```typescript\n * const UserSchema = z.object({\n *   id: z.string(),\n *   title: z.string(),\n *   created_at: z.string().datetime(),\n *   updated_at: z.string().datetime(),\n *   created_by: z.string().optional(),\n *   updated_by: z.string().optional(),\n *   email: z.string().email(),\n * });\n *\n * // Full CRUD collection\n * const USER_COLLECTION_BINDING = createCollectionBindings(\"users\", UserSchema);\n *\n * // Read-only collection (only LIST and GET)\n * const READONLY_COLLECTION_BINDING = createCollectionBindings(\"products\", ProductSchema, { readOnly: true });\n * ```\n */\nexport function createCollectionBindings<\n  TEntitySchema extends BaseCollectionEntitySchemaType,\n>(\n  collectionName: string,\n  entitySchema: TEntitySchema,\n  options?: CollectionBindingOptions,\n) {\n  const upperName = collectionName.toUpperCase();\n  const readOnly = options?.readOnly ?? false;\n\n  const bindings: ToolBinder[] = [\n    {\n      name: `DECO_COLLECTION_${upperName}_LIST` as const,\n      inputSchema: CollectionListInputSchema,\n      outputSchema: createCollectionListOutputSchema(entitySchema),\n    },\n    {\n      name: `DECO_COLLECTION_${upperName}_GET` as const,\n      inputSchema: CollectionGetInputSchema,\n      outputSchema: createCollectionGetOutputSchema(entitySchema),\n    },\n  ];\n\n  // Only include mutation operations if not read-only\n  if (!readOnly) {\n    bindings.push(\n      {\n        name: `DECO_COLLECTION_${upperName}_INSERT` as const,\n        inputSchema: createCollectionInsertInputSchema(entitySchema),\n        outputSchema: createCollectionInsertOutputSchema(entitySchema),\n        opt: true,\n      },\n      {\n        name: `DECO_COLLECTION_${upperName}_UPDATE` as const,\n        inputSchema: createCollectionUpdateInputSchema(entitySchema),\n        outputSchema: createCollectionUpdateOutputSchema(entitySchema),\n        opt: true,\n      },\n      {\n        name: `DECO_COLLECTION_${upperName}_DELETE` as const,\n        inputSchema: CollectionDeleteInputSchema,\n        outputSchema: CollectionDeleteOutputSchema,\n        opt: true,\n      },\n    );\n  }\n\n  return bindings satisfies readonly ToolBinder[];\n}\n\n/**\n * Type helper to extract the collection binding type\n */\nexport type CollectionBinding<\n  TEntitySchema extends BaseCollectionEntitySchemaType,\n> = ReturnType<typeof createCollectionBindings<TEntitySchema>>;\n\n/**\n * Type helper to extract tool names from a collection binding\n */\nexport type CollectionTools<\n  TEntitySchema extends BaseCollectionEntitySchemaType,\n> = CollectionBinding<TEntitySchema>[number][\"name\"];\n\n// Export types for TypeScript usage\nexport type CollectionListInput = z.infer<typeof CollectionListInputSchema>;\nexport type CollectionGetInput = z.infer<typeof CollectionGetInputSchema>;\nexport type CollectionDeleteInput = z.infer<typeof CollectionDeleteInputSchema>;\nexport type CollectionDeleteOutput = z.infer<\n  typeof CollectionDeleteOutputSchema\n>;\nexport type OrderByExpression = z.infer<typeof OrderByExpressionSchema>;\n"]}