rads-db 3.2.22 → 3.2.24

package/integrations/getOpenApiSpec.cjs

@@ -34,10 +34,28 @@ function primitiveToOas(type) {
       return {};
   }
 }
+function relationToOas(field, schema) {
+  const properties = {
+    id: {
+      type: "string"
+    }
+  };
+  for (const fname of field.relationDenormFields ?? []) {
+    const relField = schema[field.type]?.fields?.[fname];
+    properties[fname] = relField ? primitiveToOas(relField.type) : {};
+  }
+  return {
+    type: "object",
+    required: ["id"],
+    properties
+  };
+}
 function fieldToOas(field, schema) {
   const entry = schema[field.type];
   let itemSchema;
-  if (entry) {
+  if (field.isRelation) {
+    itemSchema = relationToOas(field, schema);
+  } else if (entry) {
     itemSchema = entry.enumValues ? {
       type: "string",
       enum: Object.keys(entry.enumValues)
@@ -76,14 +94,174 @@ function buildObjectSchema(entity, schema, allOptional = false) {
     } : {})
   };
 }
-const whereSchema = {
-  type: "object",
-  additionalProperties: true
+const stringOps = name => {
+  const s = {
+    type: "string"
+  };
+  return {
+    [`${name}_ieq`]: s,
+    [`${name}_istartsWith`]: s,
+    [`${name}_startsWith`]: s,
+    [`${name}_icontains`]: s,
+    [`${name}_contains`]: s,
+    [`${name}_iendsWith`]: s,
+    [`${name}_endsWith`]: s,
+    [`${name}_gt`]: s,
+    [`${name}_gte`]: s,
+    [`${name}_lt`]: s,
+    [`${name}_lte`]: s
+  };
 };
-const includeSchema = {
-  type: "object",
-  additionalProperties: true
+const numberOps = name => {
+  const n = {
+    type: "number"
+  };
+  return {
+    [`${name}_gt`]: n,
+    [`${name}_gte`]: n,
+    [`${name}_lt`]: n,
+    [`${name}_lte`]: n
+  };
 };
+const relationWhereOas = () => ({
+  type: "object",
+  properties: {
+    id: {
+      type: "string"
+    },
+    id_in: {
+      type: "array",
+      items: {
+        type: "string"
+      }
+    }
+  }
+});
+function addPrimitiveWhereProps(props, name, type) {
+  props[name] = primitiveToOas(type);
+  if (type !== "boolean") props[`${name}_in`] = {
+    type: "array",
+    items: primitiveToOas(type)
+  };
+  if (type === "string") Object.assign(props, stringOps(name));else if (type === "number") Object.assign(props, numberOps(name));else if (type === "Record<string, any>") props[`${name}_jsonContains`] = {
+    $ref: "#/components/schemas/WhereJsonContains"
+  };
+}
+function buildWhereProps(typeDef, schema) {
+  const props = {};
+  for (const [, field] of Object.entries(typeDef.fields ?? {})) {
+    if (field.isInverseRelation) continue;
+    const {
+      name,
+      type,
+      isRelation,
+      isRequired,
+      isArray
+    } = field;
+    const entry = schema[type];
+    const isPrimitive = !entry;
+    const isEnum = !!entry?.enumValues;
+    const isObject = !!entry?.fields;
+    const optional = !isRequired;
+    const enumSchema = isEnum ? {
+      type: "string",
+      enum: Object.keys(entry.enumValues)
+    } : {};
+    if (isArray) {
+      if (isPrimitive || isEnum) props[`${name}_arrayContains`] = isEnum ? enumSchema : primitiveToOas(type);else if (isRelation) props[`${name}_some`] = relationWhereOas();else if (isObject) props[`${name}_some`] = {
+        $ref: `#/components/schemas/${type}Where`
+      };
+      props[`${name}_isEmpty`] = {
+        type: "boolean"
+      };
+      if (optional) props[`${name}_isNull`] = {
+        type: "boolean"
+      };
+      continue;
+    }
+    if (isRelation) {
+      props[name] = relationWhereOas();
+    } else if (isObject) {
+      props[name] = {
+        $ref: `#/components/schemas/${type}Where`
+      };
+    } else if (isEnum) {
+      props[name] = enumSchema;
+      props[`${name}_in`] = {
+        type: "array",
+        items: enumSchema
+      };
+      Object.assign(props, stringOps(name));
+    } else {
+      addPrimitiveWhereProps(props, name, type);
+    }
+    if (optional) props[`${name}_isNull`] = {
+      type: "boolean"
+    };
+  }
+  return props;
+}
+function buildWhereSchema(typeName, typeDef, schema) {
+  const selfRef = `#/components/schemas/${typeName}Where`;
+  return {
+    type: "object",
+    properties: {
+      _not: {
+        $ref: selfRef
+      },
+      _and: {
+        type: "array",
+        items: {
+          $ref: selfRef
+        }
+      },
+      _or: {
+        type: "array",
+        items: {
+          $ref: selfRef
+        }
+      },
+      ...buildWhereProps(typeDef, schema)
+    }
+  };
+}
+function buildIncludeSchema(typeDef, schema) {
+  const primitiveFields = [];
+  const includeProps = {};
+  for (const [, field] of Object.entries(typeDef.fields ?? {})) {
+    if (field.isInverseRelation) continue;
+    const entry = schema[field.type];
+    const canSubInclude = field.isRelation || entry?.fields && !entry.enumValues;
+    if (canSubInclude) {
+      includeProps[field.name] = {
+        $ref: `#/components/schemas/${field.type}Include`
+      };
+    } else {
+      primitiveFields.push(field.name);
+    }
+  }
+  return {
+    type: "object",
+    properties: {
+      _pick: {
+        type: "array",
+        items: {
+          type: "string",
+          enum: primitiveFields
+        }
+      },
+      ...includeProps
+    }
+  };
+}
+function buildAggEnum(typeDef) {
+  const values = ["_count"];
+  for (const [, field] of Object.entries(typeDef.fields ?? {})) {
+    if (field.isInverseRelation || field.isArray || field.isRelation) continue;
+    if (field.type === "number") values.push(`${field.name}_min`, `${field.name}_max`, `${field.name}_sum`);
+  }
+  return values;
+}
 const paginationProps = {
   cursor: {
     type: "string"
@@ -103,36 +281,6 @@ const paginationProps = {
     description: "Multiple order-by expressions"
   }
 };
-const getRequestSchema = {
-  type: "object",
-  properties: {
-    where: whereSchema,
-    include: includeSchema
-  }
-};
-const getManyRequestSchema = {
-  type: "object",
-  properties: {
-    where: whereSchema,
-    include: includeSchema,
-    ...paginationProps
-  }
-};
-const getAggRequestSchema = {
-  type: "object",
-  required: ["agg"],
-  properties: {
-    where: whereSchema,
-    agg: {
-      type: "array",
-      items: {
-        type: "string"
-      },
-      description: 'Aggregation operations: "_count", "field_min", "field_max", "field_sum"'
-    },
-    ...paginationProps
-  }
-};
 function jsonBody(s) {
   return {
     required: true,
@@ -164,6 +312,22 @@ function getOpenApiSpec(options, openApiOptions) {
   const base = prefix.endsWith("/") ? prefix.slice(0, -1) : prefix;
   const paths = {};
   const schemas = {};
+  schemas.WhereJsonContains = {
+    type: "object",
+    required: ["path"],
+    properties: {
+      path: {
+        type: "string",
+        description: 'JSON path, e.g. "meta.countries[0].name"'
+      },
+      isNull: {
+        type: "boolean"
+      },
+      value: {
+        description: "Expected value at path (string, number, or boolean)"
+      }
+    }
+  };
   paths[`${base}/me`] = {
     get: {
       summary: "Get current user",
@@ -242,17 +406,52 @@ function getOpenApiSpec(options, openApiOptions) {
       handlePlural
     } = entity;
     const tag = name;
-    schemas[name] = buildObjectSchema(entity, schema);
-    schemas[`${name}Put`] = buildObjectSchema(entity, schema, true);
-    schemas[`${name}Put`].required = ["id"];
     const ref = n => ({
       $ref: `#/components/schemas/${n}`
     });
+    schemas[name] = buildObjectSchema(entity, schema);
+    schemas[`${name}Put`] = buildObjectSchema(entity, schema, true);
+    schemas[`${name}Put`].required = ["id"];
+    schemas[`${name}Where`] = buildWhereSchema(name, entity, schema);
+    schemas[`${name}Include`] = buildIncludeSchema(entity, schema);
+    const aggValues = buildAggEnum(entity);
+    const aggSchema = {
+      type: "array",
+      items: {
+        type: "string",
+        enum: aggValues
+      },
+      description: "Aggregation operations to compute"
+    };
+    const getReqBody = {
+      type: "object",
+      properties: {
+        where: ref(`${name}Where`),
+        include: ref(`${name}Include`)
+      }
+    };
+    const getManyReqBody = {
+      type: "object",
+      properties: {
+        where: ref(`${name}Where`),
+        include: ref(`${name}Include`),
+        ...paginationProps
+      }
+    };
+    const getAggReqBody = {
+      type: "object",
+      required: ["agg"],
+      properties: {
+        where: ref(`${name}Where`),
+        agg: aggSchema,
+        ...paginationProps
+      }
+    };
     paths[`${base}/${handle}`] = {
       post: {
         summary: `Get ${name}`,
         tags: [tag],
-        requestBody: jsonBody(getRequestSchema),
+        requestBody: jsonBody(getReqBody),
         responses: jsonOk(ref(name), `${name} object`)
       },
       put: {
@@ -272,7 +471,7 @@ function getOpenApiSpec(options, openApiOptions) {
       post: {
         summary: `Get many ${name} objects`,
         tags: [tag],
-        requestBody: jsonBody(getManyRequestSchema),
+        requestBody: jsonBody(getManyReqBody),
         responses: jsonOk({
           type: "object",
           required: ["nodes"],
@@ -311,7 +510,7 @@ function getOpenApiSpec(options, openApiOptions) {
       post: {
         summary: `Aggregate ${name} data`,
         tags: [tag],
-        requestBody: jsonBody(getAggRequestSchema),
+        requestBody: jsonBody(getAggReqBody),
         responses: jsonOk({
           type: "object",
           additionalProperties: {
@@ -324,7 +523,7 @@ function getOpenApiSpec(options, openApiOptions) {
   }
   for (const key in schema) {
     const entry = schema[key];
-    if (entry.decorators?.entity || schemas[key]) continue;
+    if (entry.decorators?.entity) continue;
     if (entry.enumValues) {
       schemas[key] = {
         type: "string",
@@ -334,7 +533,9 @@ function getOpenApiSpec(options, openApiOptions) {
         } : {})
       };
     } else if (entry.fields) {
-      schemas[key] = buildObjectSchema(entry, schema);
+      if (!schemas[key]) schemas[key] = buildObjectSchema(entry, schema);
+      schemas[`${key}Where`] = buildWhereSchema(key, entry, schema);
+      schemas[`${key}Include`] = buildIncludeSchema(entry, schema);
     }
   }
   return {

package/integrations/getOpenApiSpec.mjs

@@ -14,10 +14,20 @@ function primitiveToOas(type) {
       return {};
   }
 }
+function relationToOas(field, schema) {
+  const properties = { id: { type: "string" } };
+  for (const fname of field.relationDenormFields ?? []) {
+    const relField = schema[field.type]?.fields?.[fname];
+    properties[fname] = relField ? primitiveToOas(relField.type) : {};
+  }
+  return { type: "object", required: ["id"], properties };
+}
 function fieldToOas(field, schema) {
   const entry = schema[field.type];
   let itemSchema;
-  if (entry) {
+  if (field.isRelation) {
+    itemSchema = relationToOas(field, schema);
+  } else if (entry) {
     itemSchema = entry.enumValues ? { type: "string", enum: Object.keys(entry.enumValues) } : { $ref: `#/components/schemas/${field.type}` };
   } else {
     itemSchema = primitiveToOas(field.type);
@@ -42,35 +52,119 @@ function buildObjectSchema(entity, schema, allOptional = false) {
     ...required.length > 0 ? { required } : {}
   };
 }
-const whereSchema = { type: "object", additionalProperties: true };
-const includeSchema = { type: "object", additionalProperties: true };
+const stringOps = (name) => {
+  const s = { type: "string" };
+  return {
+    [`${name}_ieq`]: s,
+    [`${name}_istartsWith`]: s,
+    [`${name}_startsWith`]: s,
+    [`${name}_icontains`]: s,
+    [`${name}_contains`]: s,
+    [`${name}_iendsWith`]: s,
+    [`${name}_endsWith`]: s,
+    [`${name}_gt`]: s,
+    [`${name}_gte`]: s,
+    [`${name}_lt`]: s,
+    [`${name}_lte`]: s
+  };
+};
+const numberOps = (name) => {
+  const n = { type: "number" };
+  return { [`${name}_gt`]: n, [`${name}_gte`]: n, [`${name}_lt`]: n, [`${name}_lte`]: n };
+};
+const relationWhereOas = () => ({
+  type: "object",
+  properties: { id: { type: "string" }, id_in: { type: "array", items: { type: "string" } } }
+});
+function addPrimitiveWhereProps(props, name, type) {
+  props[name] = primitiveToOas(type);
+  if (type !== "boolean") props[`${name}_in`] = { type: "array", items: primitiveToOas(type) };
+  if (type === "string") Object.assign(props, stringOps(name));
+  else if (type === "number") Object.assign(props, numberOps(name));
+  else if (type === "Record<string, any>")
+    props[`${name}_jsonContains`] = { $ref: "#/components/schemas/WhereJsonContains" };
+}
+function buildWhereProps(typeDef, schema) {
+  const props = {};
+  for (const [, field] of Object.entries(typeDef.fields ?? {})) {
+    if (field.isInverseRelation) continue;
+    const { name, type, isRelation, isRequired, isArray } = field;
+    const entry = schema[type];
+    const isPrimitive = !entry;
+    const isEnum = !!entry?.enumValues;
+    const isObject = !!entry?.fields;
+    const optional = !isRequired;
+    const enumSchema = isEnum ? { type: "string", enum: Object.keys(entry.enumValues) } : {};
+    if (isArray) {
+      if (isPrimitive || isEnum) props[`${name}_arrayContains`] = isEnum ? enumSchema : primitiveToOas(type);
+      else if (isRelation) props[`${name}_some`] = relationWhereOas();
+      else if (isObject) props[`${name}_some`] = { $ref: `#/components/schemas/${type}Where` };
+      props[`${name}_isEmpty`] = { type: "boolean" };
+      if (optional) props[`${name}_isNull`] = { type: "boolean" };
+      continue;
+    }
+    if (isRelation) {
+      props[name] = relationWhereOas();
+    } else if (isObject) {
+      props[name] = { $ref: `#/components/schemas/${type}Where` };
+    } else if (isEnum) {
+      props[name] = enumSchema;
+      props[`${name}_in`] = { type: "array", items: enumSchema };
+      Object.assign(props, stringOps(name));
+    } else {
+      addPrimitiveWhereProps(props, name, type);
+    }
+    if (optional) props[`${name}_isNull`] = { type: "boolean" };
+  }
+  return props;
+}
+function buildWhereSchema(typeName, typeDef, schema) {
+  const selfRef = `#/components/schemas/${typeName}Where`;
+  return {
+    type: "object",
+    properties: {
+      _not: { $ref: selfRef },
+      _and: { type: "array", items: { $ref: selfRef } },
+      _or: { type: "array", items: { $ref: selfRef } },
+      ...buildWhereProps(typeDef, schema)
+    }
+  };
+}
+function buildIncludeSchema(typeDef, schema) {
+  const primitiveFields = [];
+  const includeProps = {};
+  for (const [, field] of Object.entries(typeDef.fields ?? {})) {
+    if (field.isInverseRelation) continue;
+    const entry = schema[field.type];
+    const canSubInclude = field.isRelation || entry?.fields && !entry.enumValues;
+    if (canSubInclude) {
+      includeProps[field.name] = { $ref: `#/components/schemas/${field.type}Include` };
+    } else {
+      primitiveFields.push(field.name);
+    }
+  }
+  return {
+    type: "object",
+    properties: {
+      _pick: { type: "array", items: { type: "string", enum: primitiveFields } },
+      ...includeProps
+    }
+  };
+}
+function buildAggEnum(typeDef) {
+  const values = ["_count"];
+  for (const [, field] of Object.entries(typeDef.fields ?? {})) {
+    if (field.isInverseRelation || field.isArray || field.isRelation) continue;
+    if (field.type === "number") values.push(`${field.name}_min`, `${field.name}_max`, `${field.name}_sum`);
+  }
+  return values;
+}
 const paginationProps = {
   cursor: { type: "string" },
   maxItemCount: { type: "integer" },
   orderBy: { type: "string", description: 'Single order-by expression, e.g. "name_asc"' },
   orderByArray: { type: "array", items: { type: "string" }, description: "Multiple order-by expressions" }
 };
-const getRequestSchema = {
-  type: "object",
-  properties: { where: whereSchema, include: includeSchema }
-};
-const getManyRequestSchema = {
-  type: "object",
-  properties: { where: whereSchema, include: includeSchema, ...paginationProps }
-};
-const getAggRequestSchema = {
-  type: "object",
-  required: ["agg"],
-  properties: {
-    where: whereSchema,
-    agg: {
-      type: "array",
-      items: { type: "string" },
-      description: 'Aggregation operations: "_count", "field_min", "field_max", "field_sum"'
-    },
-    ...paginationProps
-  }
-};
 function jsonBody(s) {
   return { required: true, content: { "application/json": { schema: s } } };
 }
@@ -83,6 +177,15 @@ export function getOpenApiSpec(options, openApiOptions) {
   const base = prefix.endsWith("/") ? prefix.slice(0, -1) : prefix;
   const paths = {};
   const schemas = {};
+  schemas.WhereJsonContains = {
+    type: "object",
+    required: ["path"],
+    properties: {
+      path: { type: "string", description: 'JSON path, e.g. "meta.countries[0].name"' },
+      isNull: { type: "boolean" },
+      value: { description: "Expected value at path (string, number, or boolean)" }
+    }
+  };
   paths[`${base}/me`] = {
     get: {
       summary: "Get current user",
@@ -133,15 +236,36 @@ export function getOpenApiSpec(options, openApiOptions) {
     if (!entity.decorators?.entity) continue;
     const { name, handle, handlePlural } = entity;
     const tag = name;
+    const ref = (n) => ({ $ref: `#/components/schemas/${n}` });
     schemas[name] = buildObjectSchema(entity, schema);
     schemas[`${name}Put`] = buildObjectSchema(entity, schema, true);
     schemas[`${name}Put`].required = ["id"];
-    const ref = (n) => ({ $ref: `#/components/schemas/${n}` });
+    schemas[`${name}Where`] = buildWhereSchema(name, entity, schema);
+    schemas[`${name}Include`] = buildIncludeSchema(entity, schema);
+    const aggValues = buildAggEnum(entity);
+    const aggSchema = {
+      type: "array",
+      items: { type: "string", enum: aggValues },
+      description: "Aggregation operations to compute"
+    };
+    const getReqBody = {
+      type: "object",
+      properties: { where: ref(`${name}Where`), include: ref(`${name}Include`) }
+    };
+    const getManyReqBody = {
+      type: "object",
+      properties: { where: ref(`${name}Where`), include: ref(`${name}Include`), ...paginationProps }
+    };
+    const getAggReqBody = {
+      type: "object",
+      required: ["agg"],
+      properties: { where: ref(`${name}Where`), agg: aggSchema, ...paginationProps }
+    };
     paths[`${base}/${handle}`] = {
       post: {
         summary: `Get ${name}`,
         tags: [tag],
-        requestBody: jsonBody(getRequestSchema),
+        requestBody: jsonBody(getReqBody),
         responses: jsonOk(ref(name), `${name} object`)
       },
       put: {
@@ -159,7 +283,7 @@ export function getOpenApiSpec(options, openApiOptions) {
       post: {
         summary: `Get many ${name} objects`,
         tags: [tag],
-        requestBody: jsonBody(getManyRequestSchema),
+        requestBody: jsonBody(getManyReqBody),
         responses: jsonOk(
           {
             type: "object",
@@ -187,7 +311,7 @@ export function getOpenApiSpec(options, openApiOptions) {
       post: {
         summary: `Aggregate ${name} data`,
         tags: [tag],
-        requestBody: jsonBody(getAggRequestSchema),
+        requestBody: jsonBody(getAggReqBody),
         responses: jsonOk(
           { type: "object", additionalProperties: { type: "number", nullable: true } },
           `${name} aggregation result`
@@ -197,7 +321,7 @@ export function getOpenApiSpec(options, openApiOptions) {
   }
   for (const key in schema) {
     const entry = schema[key];
-    if (entry.decorators?.entity || schemas[key]) continue;
+    if (entry.decorators?.entity) continue;
     if (entry.enumValues) {
       schemas[key] = {
         type: "string",
@@ -205,7 +329,9 @@ export function getOpenApiSpec(options, openApiOptions) {
         ...entry.comment ? { description: entry.comment } : {}
       };
     } else if (entry.fields) {
-      schemas[key] = buildObjectSchema(entry, schema);
+      if (!schemas[key]) schemas[key] = buildObjectSchema(entry, schema);
+      schemas[`${key}Where`] = buildWhereSchema(key, entry, schema);
+      schemas[`${key}Include`] = buildIncludeSchema(entry, schema);
     }
   }
   return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rads-db",
-  "version": "3.2.22",
+  "version": "3.2.24",
   "description": "Say goodbye to boilerplate code and hello to efficient and elegant syntax.",
   "author": "",
   "license": "ISC",