@pylo/node 0.0.11 → 0.1.0

package/dist/index.js

@@ -48,6 +48,7 @@ async function graphqlRequest(endpoint, query, variables, options) {
 }
 
 // ../core/dist/index.js
+var VARIANT_SUFFIX = "_variants";
 var PAGINATION_FIELDS = `pagination {
     total
     current_page
@@ -55,92 +56,59 @@ var PAGINATION_FIELDS = `pagination {
     last_page
     has_more_pages
   }`;
-function buildSelectionSet(select, entityMeta, schemaMetadata, variables, variableTypes, prefix) {
-  var _a, _b;
+function buildSelectionSet(select, variables, variableTypes, prefix) {
   const fields = [];
-  const variantFieldNames = (_a = entityMeta.variantFieldNames) != null ? _a : [];
-  if (!select) {
-    fields.push(...entityMeta.scalarFieldNames);
-    for (const vf of variantFieldNames) {
-      fields.push(`${vf} { data { value variant } }`);
-    }
-    return fields.join("\n    ");
-  }
   for (const [key, value] of Object.entries(select)) {
-    if (entityMeta.scalarFieldNames.includes(key)) {
-      if (value === true) {
+    if (value === true) {
+      if (key.endsWith(VARIANT_SUFFIX)) {
+        fields.push(`${key} { data { value variant } }`);
+      } else {
         fields.push(key);
       }
       continue;
     }
-    if (variantFieldNames.includes(key)) {
-      if (value === true) {
-        fields.push(`${key} { data { value variant } }`);
-      }
-      continue;
+    if (typeof value !== "object" || value === null) continue;
+    const relation = value;
+    const argParts = [];
+    if (relation.filter !== void 0) {
+      const varName = `${prefix}${key}_filter`;
+      variables[varName] = relation.filter;
+      variableTypes.set(varName, "FilterInput");
+      argParts.push(`filter: $${varName}`);
     }
-    const relation = entityMeta.relations[key];
-    if (!relation) {
-      if (schemaMetadata.unknownFieldBehavior === "ignore") continue;
-      const validFields = [...entityMeta.scalarFieldNames, ...variantFieldNames].join(", ");
-      const validRelations = Object.keys(entityMeta.relations).join(", ");
-      throw new Error(
-        `Unknown field "${key}" on entity "${entityMeta.pascalName}". Valid fields: ${validFields}. Valid relations: ${validRelations}`
-      );
+    const wantsPagination = relation.pagination !== void 0;
+    if (wantsPagination) {
+      const varName = `${prefix}${key}_pagination`;
+      variables[varName] = relation.pagination;
+      variableTypes.set(varName, "PaginationInput");
+      argParts.push(`pagination: $${varName}`);
     }
-    const targetMeta = schemaMetadata.entities[relation.entity];
-    if (!targetMeta) continue;
-    const isHasMany = relation.type === "hasMany";
-    if (value === true) {
-      const targetFieldParts = [...targetMeta.scalarFieldNames];
-      for (const vf of (_b = targetMeta.variantFieldNames) != null ? _b : []) {
-        targetFieldParts.push(`${vf} { data { value variant } }`);
-      }
-      const targetFields = targetFieldParts.join(" ");
-      if (isHasMany) {
-        fields.push(`${key} { data { ${targetFields} } ${PAGINATION_FIELDS} }`);
-      } else {
-        fields.push(`${key} { data { ${targetFields} } }`);
-      }
-    } else if (typeof value === "object" && value !== null) {
-      const argParts = [];
-      if (value.filter !== void 0) {
-        const varName = `${prefix}${key}_filter`;
-        variables[varName] = value.filter;
-        variableTypes.set(varName, "FilterInput");
-        argParts.push(`filter: $${varName}`);
-      }
-      if (isHasMany && value.pagination !== void 0) {
-        const varName = `${prefix}${key}_pagination`;
-        variables[varName] = value.pagination;
-        variableTypes.set(varName, "PaginationInput");
-        argParts.push(`pagination: $${varName}`);
-      }
-      const args = argParts.length > 0 ? `(${argParts.join(", ")})` : "";
-      const nestedSelection = buildSelectionSet(
-        value.select,
-        targetMeta,
-        schemaMetadata,
-        variables,
-        variableTypes,
-        `${prefix}${key}_`
-      );
-      if (isHasMany) {
-        fields.push(
-          `${key}${args} { data { ${nestedSelection} } ${PAGINATION_FIELDS} }`
-        );
-      } else {
-        fields.push(`${key}${args} { data { ${nestedSelection} } }`);
-      }
+    const args = argParts.length > 0 ? `(${argParts.join(", ")})` : "";
+    if (!relation.select) {
+      throw new Error(`Relation "${key}" requires an explicit { select: {...} }.`);
+    }
+    const nestedSelection = buildSelectionSet(
+      relation.select,
+      variables,
+      variableTypes,
+      `${prefix}${key}_`
+    );
+    if (wantsPagination) {
+      fields.push(`${key}${args} { data { ${nestedSelection} } ${PAGINATION_FIELDS} }`);
+    } else {
+      fields.push(`${key}${args} { data { ${nestedSelection} } }`);
     }
   }
   return fields.join("\n    ");
 }
-function buildListQuery(entityKey, options, schemaMetadata) {
-  const entityMeta = schemaMetadata.entities[entityKey];
-  if (!entityMeta) {
-    throw new Error(`Unknown entity: ${entityKey}`);
+function requireSelect(entityKey, operation, select) {
+  if (!select || typeof select !== "object" || Object.keys(select).length === 0) {
+    throw new Error(`${operation}("${entityKey}") requires an explicit 'select'.`);
   }
+  return select;
+}
+function buildListQuery(entityKey, options) {
+  const select = requireSelect(entityKey, "list", options == null ? void 0 : options.select);
   const variables = {};
   const variableTypes = /* @__PURE__ */ new Map();
   if ((options == null ? void 0 : options.filter) !== void 0) {
@@ -151,14 +119,7 @@ function buildListQuery(entityKey, options, schemaMetadata) {
     variables["pagination"] = options.pagination;
     variableTypes.set("pagination", "PaginationInput");
   }
-  const selectionSet = buildSelectionSet(
-    options == null ? void 0 : options.select,
-    entityMeta,
-    schemaMetadata,
-    variables,
-    variableTypes,
-    "r_"
-  );
+  const selectionSet = buildSelectionSet(select, variables, variableTypes, "r_");
   const varDecls = Array.from(variableTypes.entries()).map(([name, type]) => `$${name}: ${type}`).join(", ");
   const varSection = varDecls ? `(${varDecls})` : "";
   const argParts = [];
@@ -180,21 +141,11 @@ function buildListQuery(entityKey, options, schemaMetadata) {
 }`;
   return { query, variables };
 }
-function buildByIdQuery(entityKey, id, options, schemaMetadata) {
-  const entityMeta = schemaMetadata.entities[entityKey];
-  if (!entityMeta) {
-    throw new Error(`Unknown entity: ${entityKey}`);
-  }
+function buildByIdQuery(entityKey, id, options) {
+  const select = requireSelect(entityKey, "byId", options == null ? void 0 : options.select);
   const variables = { id };
   const variableTypes = /* @__PURE__ */ new Map([["id", "ID!"]]);
-  const selectionSet = buildSelectionSet(
-    options == null ? void 0 : options.select,
-    entityMeta,
-    schemaMetadata,
-    variables,
-    variableTypes,
-    "r_"
-  );
+  const selectionSet = buildSelectionSet(select, variables, variableTypes, "r_");
   const varDecls = Array.from(variableTypes.entries()).map(([name, type]) => `$${name}: ${type}`).join(", ");
   const query = `query ${capitalize(entityKey)}ById(${varDecls}) {
   ${entityKey}ById(id: $id) {
@@ -208,6 +159,89 @@ function buildByIdQuery(entityKey, id, options, schemaMetadata) {
 function capitalize(str) {
   return str.charAt(0).toUpperCase() + str.slice(1);
 }
+var EVENT_LIST_ARG_TYPES = {
+  filter: "EventListFilterInput",
+  pagination: "PaginationInput",
+  select_fields: "[String!]",
+  interval: "String",
+  timezone: "String",
+  group_by: "[String!]",
+  startTime: "String"
+};
+var EVENT_LIST_DATA = `data
+    pagination {
+      total
+      current_page
+      per_page
+      last_page
+      has_more_pages
+    }
+    aggregations`;
+function normalizeEventFilter(filter) {
+  var _a;
+  if (!((_a = filter.dimensions) == null ? void 0 : _a.length)) return filter;
+  const dimensions = filter.dimensions.map(
+    (dim) => dim.timeBucket && dim.timeBucket.field === void 0 ? { ...dim, timeBucket: { ...dim.timeBucket, field: "ts" } } : dim
+  );
+  return { ...filter, dimensions };
+}
+function buildEventListQuery(options) {
+  const variables = {};
+  const varDecls = [];
+  const argParts = [];
+  for (const key of Object.keys(EVENT_LIST_ARG_TYPES)) {
+    const value = options == null ? void 0 : options[key];
+    if (value === void 0) continue;
+    variables[key] = key === "filter" ? normalizeEventFilter(value) : value;
+    varDecls.push(`$${key}: ${EVENT_LIST_ARG_TYPES[key]}`);
+    argParts.push(`${key}: $${key}`);
+  }
+  const varSection = varDecls.length > 0 ? `(${varDecls.join(", ")})` : "";
+  const argSection = argParts.length > 0 ? `(${argParts.join(", ")})` : "";
+  const query = `query PyloEventList${varSection} {
+  pyloEventList${argSection} {
+    ${EVENT_LIST_DATA}
+  }
+}`;
+  return { query, variables };
+}
+function buildEventPropertyKeysQuery(options) {
+  const hasFilter = (options == null ? void 0 : options.filter) !== void 0;
+  const varSection = hasFilter ? "($filter: FilterInput)" : "";
+  const argSection = hasFilter ? "(filter: $filter)" : "";
+  const query = `query PyloEventPropertyKeys${varSection} {
+  pyloEventPropertyKeys${argSection} {
+    path
+    type
+  }
+}`;
+  return {
+    query,
+    variables: hasFilter ? { filter: options.filter } : {}
+  };
+}
+function buildEventFieldValuesQuery(field, options) {
+  const varDecls = ["$field: String!"];
+  const argParts = ["field: $field"];
+  const variables = { field };
+  if ((options == null ? void 0 : options.startTime) !== void 0) {
+    varDecls.push("$startTime: String");
+    argParts.push("startTime: $startTime");
+    variables["startTime"] = options.startTime;
+  }
+  if ((options == null ? void 0 : options.limit) !== void 0) {
+    varDecls.push("$limit: Int");
+    argParts.push("limit: $limit");
+    variables["limit"] = options.limit;
+  }
+  const query = `query PyloEventFieldValues(${varDecls.join(", ")}) {
+  pyloEventFieldValues(${argParts.join(", ")}) {
+    value
+    count
+  }
+}`;
+  return { query, variables };
+}
 function buildUpsertMutation(_entityKey, pascalName, input) {
   const mutation = `mutation Update${pascalName}($input: Update${pascalName}Input!) {
   update${pascalName}(input: $input) {
@@ -286,13 +320,12 @@ async function executeGraphQL(endpoint, query, variables, auth, headers) {
   }
   return response.data;
 }
-function createEntityClient(entityKey, endpoint, metadata, auth, globalHeaders) {
+function createEntityClient(entityKey, endpoint, auth, globalHeaders) {
   return {
     async list(options) {
       const { query, variables } = buildListQuery(
         entityKey,
-        options,
-        metadata
+        options
       );
       const data = await executeGraphQL(
         endpoint,
@@ -312,8 +345,7 @@ function createEntityClient(entityKey, endpoint, metadata, auth, globalHeaders)
       const { query, variables } = buildByIdQuery(
         entityKey,
         id,
-        options,
-        metadata
+        options
       );
       const data = await executeGraphQL(
         endpoint,
@@ -328,13 +360,10 @@ function createEntityClient(entityKey, endpoint, metadata, auth, globalHeaders)
       return result.data;
     },
     async upsert(input, options) {
-      const entityMeta = metadata.entities[entityKey];
-      if (!entityMeta) {
-        throw new PyloError(`Unknown entity: ${entityKey}`);
-      }
+      const pascalName = capitalize(entityKey);
       const { query, variables } = buildUpsertMutation(
         entityKey,
-        entityMeta.pascalName,
+        pascalName,
         input
       );
       const data = await executeGraphQL(
@@ -347,7 +376,7 @@ function createEntityClient(entityKey, endpoint, metadata, auth, globalHeaders)
           flagsToHeaders(options != null ? options : {})
         )
       );
-      const mutationKey = `update${entityMeta.pascalName}`;
+      const mutationKey = `update${pascalName}`;
       const result = data[mutationKey];
       if (!result) {
         throw new PyloError(`Unexpected response shape \u2014 missing ${mutationKey}`);
@@ -355,13 +384,10 @@ function createEntityClient(entityKey, endpoint, metadata, auth, globalHeaders)
       return result.data;
     },
     async delete(ids, options) {
-      const entityMeta = metadata.entities[entityKey];
-      if (!entityMeta) {
-        throw new PyloError(`Unknown entity: ${entityKey}`);
-      }
+      const pascalName = capitalize(entityKey);
       const { query, variables } = buildDeleteMutation(
         entityKey,
-        entityMeta.pascalName,
+        pascalName,
         ids
       );
       const data = await executeGraphQL(
@@ -374,7 +400,7 @@ function createEntityClient(entityKey, endpoint, metadata, auth, globalHeaders)
           flagsToHeaders(options != null ? options : {})
         )
       );
-      const mutationKey = `delete${entityMeta.pascalName}`;
+      const mutationKey = `delete${pascalName}`;
       const result = data[mutationKey];
       if (!result) {
         throw new PyloError(`Unexpected response shape \u2014 missing ${mutationKey}`);
@@ -403,17 +429,61 @@ function createIngestEvents(endpoint, auth, globalHeaders) {
     return result.data;
   };
 }
+function createEventsClient(endpoint, auth, globalHeaders) {
+  return {
+    async list(options) {
+      const { query, variables } = buildEventListQuery(options);
+      const data = await executeGraphQL(
+        endpoint,
+        query,
+        variables,
+        auth,
+        mergeHeaders(globalHeaders, options == null ? void 0 : options.headers)
+      );
+      const result = data["pyloEventList"];
+      if (!result) {
+        throw new PyloError("Unexpected response shape \u2014 missing pyloEventList");
+      }
+      return result;
+    },
+    async propertyKeys(options) {
+      var _a;
+      const { query, variables } = buildEventPropertyKeysQuery(options);
+      const data = await executeGraphQL(
+        endpoint,
+        query,
+        variables,
+        auth,
+        mergeHeaders(globalHeaders, options == null ? void 0 : options.headers)
+      );
+      return (_a = data["pyloEventPropertyKeys"]) != null ? _a : [];
+    },
+    async fieldValues(field, options) {
+      var _a;
+      const { query, variables } = buildEventFieldValuesQuery(field, options);
+      const data = await executeGraphQL(
+        endpoint,
+        query,
+        variables,
+        auth,
+        mergeHeaders(globalHeaders, options == null ? void 0 : options.headers)
+      );
+      return (_a = data["pyloEventFieldValues"]) != null ? _a : [];
+    }
+  };
+}
 function createPyloClient(options) {
   const endpoint = getEndpoint(options.endpoint);
-  const metadata = options.schemaMetadata;
   const auth = options.auth;
   const globalHeaders = options.headers;
   const ingestEvents = createIngestEvents(endpoint, auth, globalHeaders);
+  const events = createEventsClient(endpoint, auth, globalHeaders);
   return new Proxy({}, {
     get(_target, prop) {
       if (typeof prop !== "string") return void 0;
       if (prop === "ingestEvents") return ingestEvents;
-      return createEntityClient(prop, endpoint, metadata, auth, globalHeaders);
+      if (prop === "events") return events;
+      return createEntityClient(prop, endpoint, auth, globalHeaders);
     }
   });
 }
@@ -422,12 +492,26 @@ function createPyloClient(options) {
 function createPyloNode(options) {
   return createPyloClient({
     ...options.endpoint !== void 0 ? { endpoint: options.endpoint } : {},
-    schemaMetadata: options.schemaMetadata,
     auth: async () => ({ apiKey: options.apiKey }),
     ...options.headers !== void 0 ? { headers: options.headers } : {}
   });
 }
+var pylo = new Proxy(
+  {},
+  {
+    get(_target, prop) {
+      const client = globalThis["__PYLO_FLOW_CLIENT__"];
+      if (!client) {
+        throw new Error(
+          "Pylo flow client unavailable (globalThis.__PYLO_FLOW_CLIENT__ is unset). `pylo` is only usable inside a Pylo flow action."
+        );
+      }
+      return client[prop];
+    }
+  }
+);
 export {
   PyloError,
-  createPyloNode
+  createPyloNode,
+  pylo
 };

package/dist/schema.d.ts

@@ -0,0 +1 @@
+export { AnalyzedEntity, AnalyzedField, AnalyzedRelation, ENTITY_LIST_QUERY, EntityListResponse, RawEntity, RawEntityField, RawEntityRelation, SchemaFetcher, analyzeEntities, fetchSchemaWith, generateEntitiesFile, generateIndexFile } from '@pylo/core/schema';