@uniformdev/mesh-edgehancer-sdk 20.50.2-alpha.146 → 20.50.2-alpha.167

package/dist/index.d.mts

@@ -139,20 +139,12 @@ declare const afterAIDataResourceEditResultSchema: z.ZodObject<{
     summary: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 declare const afterAIDataResourceEditContextSchema: z.ZodObject<{
-    /**
-     * The the data type of the data resource being edited (merged with its data source)
-     * NOTE: this can contain secrets, API keys, etc. Do not directly expose it to the AI agent!
-     * NOTE: this does not include the current value's variables, if any
-     */
     mergedDataType: z.ZodCustom<MergedDataType, MergedDataType>;
-    /** Which data source variant is currently active (undefined = published data) */
     dataSourceVariant: z.ZodOptional<z.ZodCustom<"unpublished", "unpublished">>;
-    /** The edit request details */
     editRequest: z.ZodObject<{
         edit: z.ZodString;
         currentValue: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     }, z.core.$strip>;
-    /** AI invocation context */
     invocationContext: z.ZodEnum<{
         composition: "composition";
         compositionPattern: "compositionPattern";
@@ -161,13 +153,9 @@ declare const afterAIDataResourceEditContextSchema: z.ZodObject<{
         entryPattern: "entryPattern";
         general: "general";
     }>;
-    /** User ID making the edit */
     userId: z.ZodString;
-    /** Project ID */
     projectId: z.ZodString;
-    /** The new value generated by AI */
     newValue: z.ZodRecord<z.ZodString, z.ZodString>;
-    /** The result from the AI editing process */
     result: z.ZodObject<{
         success: z.ZodBoolean;
         summary: z.ZodOptional<z.ZodString>;
@@ -248,6 +236,45 @@ type AfterAIEditResult = z.infer<typeof afterAIEditResultSchema>;
  */
 type AfterAIEditHookFn = (context: AfterAIEditContext) => Promise<AfterAIEditResult>;
 
+/**
+ * A normalized record of one bound parameter value that consumed a data
+ * resource somewhere in the composition tree. Custom edgehancer authors can
+ * use this to derive minimal upstream queries (e.g. GraphQL field selection,
+ * downstream `select.*` forwarding) instead of always fetching the full
+ * resource shape.
+ */
+type CollectedBinding = {
+    /**
+     * Data resource name referenced by the binding (post-alias-deref,
+     * post-loop-synthesis when surfaced from canvas-sdk's scope walker — the
+     * raw parsed name when produced by `collectComponentBindings`). Used as
+     * the key into per-DR binding buckets.
+     */
+    dataResource: string;
+    /**
+     * The full effective pointer for this binding, e.g. `/items/fields/title`,
+     * _including_ the leading `/<dataResource>` segment. Per-integration
+     * translators (UC's `deriveUniformContentProjection`, custom edgehancer
+     * authors) scan this for `/fields/<name>` and `/parameters/<name>` segments
+     * to derive a minimal upstream query.
+     */
+    pointer: string;
+    /**
+     * The JSON pointer expression _inside_ the data resource, with the leading
+     * `/<dataResource>` segment removed. May be undefined if the binding
+     * references the whole resource.
+     */
+    dataExpression: string | undefined;
+    /** Parameter id (property name) where the binding was found. */
+    parameterId: string;
+    /**
+     * Locale the binding's locale-scoped value was found under, if any. The
+     * empty string is normalized to undefined.
+     */
+    locale: string | undefined;
+    /** Condition index, or -1 for the default (non-conditional) value. */
+    conditionIndex: number;
+};
 type RequestEdgehancerDataResourceContext = {
     /**
      * The data resource to fetch.
@@ -399,20 +426,12 @@ declare const COLLECTION_MAX_LIMIT = 50;
 declare const COLLECTION_DEFAULT_OFFSET = 0;
 
 declare const createAIDataResourceEditContextSchema: z.ZodObject<{
-    /**
-     * The the data type of the data resource being edited (merged with its data source)
-     * NOTE: this can contain secrets, API keys, etc. Do not directly expose it to the AI agent!
-     * NOTE: this does not include the current value's variables, if any
-     */
     mergedDataType: z.ZodCustom<MergedDataType, MergedDataType>;
-    /** Which data source variant is currently active (undefined = published data) */
     dataSourceVariant: z.ZodOptional<z.ZodCustom<"unpublished", "unpublished">>;
-    /** The edit request details */
     editRequest: z.ZodObject<{
         edit: z.ZodString;
         currentValue: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     }, z.core.$strip>;
-    /** AI invocation context */
     invocationContext: z.ZodEnum<{
         composition: "composition";
         compositionPattern: "compositionPattern";
@@ -421,9 +440,7 @@ declare const createAIDataResourceEditContextSchema: z.ZodObject<{
         entryPattern: "entryPattern";
         general: "general";
     }>;
-    /** User ID making the edit */
     userId: z.ZodString;
-    /** Project ID */
     projectId: z.ZodString;
 }, z.core.$strict>;
 type CreateAIDataResourceEditContext = z.infer<typeof createAIDataResourceEditContextSchema>;
@@ -551,6 +568,14 @@ type PreRequestEdgehancerDataResourceContext = {
      * The data resource definition that will be requested.
      */
     dataResource: EdgehancerMergedDataType;
+    /**
+     * The set of bindings in the originating composition/entry that consume this
+     * data resource. This can be used to derive a data projection to the target API.
+     *
+     * Undefined for editor / authoring fetches so the editor can read every
+     * field to create new bindings. Never an empty array — unused data resources are automatically skipped from being fetched.
+     */
+    bindings?: readonly CollectedBinding[];
 };
 type PreRequestEdgehancerContext = {
     fetchContext: DataResourceFetchContext;
@@ -761,4 +786,4 @@ declare function getDataResourceQueryString({ parameters, url }: EdgehancerMerge
 /** Gets the HTTP headers for a data resource */
 declare function getDataResourceHeaders({ headers }: EdgehancerMergedDataType): Headers;
 
-export { type AfterAIDataResourceEditContext, type AfterAIDataResourceEditHookFn, type AfterAIDataResourceEditResult, type AfterAIEditContext, type AfterAIEditHookFn, type AfterAIEditResult, COLLECTION_DEFAULT_LIMIT, COLLECTION_DEFAULT_OFFSET, COLLECTION_MAX_LIMIT, type ConvertBatchResultsToEdgehancerResultOptions, type CreateAIDataResourceEditContext, type CreateAIDataResourceEditHookFn, type CreateAIDataResourceEditResult, type CreateAIEditContext, type CreateAIEditHookFn, type CreateAIEditResult, type CustomEdgehancerDefinition, type DataResource, type DataResourceFetchContext, type EdgehancerDataIssue, type EdgehancerMergedDataType, type MergedDataType, type PreRequestEdgehancerContext, type PreRequestEdgehancerDataResourceContext, type PreRequestEdgehancerDataResourceResult, type PreRequestEdgehancerResult, type PreRequestHookFn, type RequestEdgehancerContext, type RequestEdgehancerDataResourceContext, type RequestEdgehancerDataResourceResolutionResult, type RequestEdgehancerResult, type RequestHookFn, type ResolveBatchIdsResult, afterAIDataResourceEditContextSchema, afterAIDataResourceEditResultSchema, afterAIEditContextSchema, afterAIEditResultSchema, convertBatchResultsToEdgehancerResult, createAIDataResourceEditContextSchema, createAIDataResourceEditResultSchema, createAIEditContextSchema, createAIEditResultSchema, dataResourceSchema, edgehancerMergedDataTypeSchema, getDataResourceAsRequest, getDataResourceHeaders, getDataResourceQueryString, getDataResourceUrl, mergedDataTypeSchema, preRequestEdgehancerDataResourceResultSchema, preRequestEdgehancerResultSchema, requestEdgehancerDataResourceResolutionResultSchema, requestEdgehancerResultSchema, resolveBatchFetchIds, resolvingIssueSchema };
+export { type AfterAIDataResourceEditContext, type AfterAIDataResourceEditHookFn, type AfterAIDataResourceEditResult, type AfterAIEditContext, type AfterAIEditHookFn, type AfterAIEditResult, COLLECTION_DEFAULT_LIMIT, COLLECTION_DEFAULT_OFFSET, COLLECTION_MAX_LIMIT, type CollectedBinding, type ConvertBatchResultsToEdgehancerResultOptions, type CreateAIDataResourceEditContext, type CreateAIDataResourceEditHookFn, type CreateAIDataResourceEditResult, type CreateAIEditContext, type CreateAIEditHookFn, type CreateAIEditResult, type CustomEdgehancerDefinition, type DataResource, type DataResourceFetchContext, type EdgehancerDataIssue, type EdgehancerMergedDataType, type MergedDataType, type PreRequestEdgehancerContext, type PreRequestEdgehancerDataResourceContext, type PreRequestEdgehancerDataResourceResult, type PreRequestEdgehancerResult, type PreRequestHookFn, type RequestEdgehancerContext, type RequestEdgehancerDataResourceContext, type RequestEdgehancerDataResourceResolutionResult, type RequestEdgehancerResult, type RequestHookFn, type ResolveBatchIdsResult, afterAIDataResourceEditContextSchema, afterAIDataResourceEditResultSchema, afterAIEditContextSchema, afterAIEditResultSchema, convertBatchResultsToEdgehancerResult, createAIDataResourceEditContextSchema, createAIDataResourceEditResultSchema, createAIEditContextSchema, createAIEditResultSchema, dataResourceSchema, edgehancerMergedDataTypeSchema, getDataResourceAsRequest, getDataResourceHeaders, getDataResourceQueryString, getDataResourceUrl, mergedDataTypeSchema, preRequestEdgehancerDataResourceResultSchema, preRequestEdgehancerResultSchema, requestEdgehancerDataResourceResolutionResultSchema, requestEdgehancerResultSchema, resolveBatchFetchIds, resolvingIssueSchema };

package/dist/index.d.ts

@@ -139,20 +139,12 @@ declare const afterAIDataResourceEditResultSchema: z.ZodObject<{
     summary: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 declare const afterAIDataResourceEditContextSchema: z.ZodObject<{
-    /**
-     * The the data type of the data resource being edited (merged with its data source)
-     * NOTE: this can contain secrets, API keys, etc. Do not directly expose it to the AI agent!
-     * NOTE: this does not include the current value's variables, if any
-     */
     mergedDataType: z.ZodCustom<MergedDataType, MergedDataType>;
-    /** Which data source variant is currently active (undefined = published data) */
     dataSourceVariant: z.ZodOptional<z.ZodCustom<"unpublished", "unpublished">>;
-    /** The edit request details */
     editRequest: z.ZodObject<{
         edit: z.ZodString;
         currentValue: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     }, z.core.$strip>;
-    /** AI invocation context */
     invocationContext: z.ZodEnum<{
         composition: "composition";
         compositionPattern: "compositionPattern";
@@ -161,13 +153,9 @@ declare const afterAIDataResourceEditContextSchema: z.ZodObject<{
         entryPattern: "entryPattern";
         general: "general";
     }>;
-    /** User ID making the edit */
     userId: z.ZodString;
-    /** Project ID */
     projectId: z.ZodString;
-    /** The new value generated by AI */
     newValue: z.ZodRecord<z.ZodString, z.ZodString>;
-    /** The result from the AI editing process */
     result: z.ZodObject<{
         success: z.ZodBoolean;
         summary: z.ZodOptional<z.ZodString>;
@@ -248,6 +236,45 @@ type AfterAIEditResult = z.infer<typeof afterAIEditResultSchema>;
  */
 type AfterAIEditHookFn = (context: AfterAIEditContext) => Promise<AfterAIEditResult>;
 
+/**
+ * A normalized record of one bound parameter value that consumed a data
+ * resource somewhere in the composition tree. Custom edgehancer authors can
+ * use this to derive minimal upstream queries (e.g. GraphQL field selection,
+ * downstream `select.*` forwarding) instead of always fetching the full
+ * resource shape.
+ */
+type CollectedBinding = {
+    /**
+     * Data resource name referenced by the binding (post-alias-deref,
+     * post-loop-synthesis when surfaced from canvas-sdk's scope walker — the
+     * raw parsed name when produced by `collectComponentBindings`). Used as
+     * the key into per-DR binding buckets.
+     */
+    dataResource: string;
+    /**
+     * The full effective pointer for this binding, e.g. `/items/fields/title`,
+     * _including_ the leading `/<dataResource>` segment. Per-integration
+     * translators (UC's `deriveUniformContentProjection`, custom edgehancer
+     * authors) scan this for `/fields/<name>` and `/parameters/<name>` segments
+     * to derive a minimal upstream query.
+     */
+    pointer: string;
+    /**
+     * The JSON pointer expression _inside_ the data resource, with the leading
+     * `/<dataResource>` segment removed. May be undefined if the binding
+     * references the whole resource.
+     */
+    dataExpression: string | undefined;
+    /** Parameter id (property name) where the binding was found. */
+    parameterId: string;
+    /**
+     * Locale the binding's locale-scoped value was found under, if any. The
+     * empty string is normalized to undefined.
+     */
+    locale: string | undefined;
+    /** Condition index, or -1 for the default (non-conditional) value. */
+    conditionIndex: number;
+};
 type RequestEdgehancerDataResourceContext = {
     /**
      * The data resource to fetch.
@@ -399,20 +426,12 @@ declare const COLLECTION_MAX_LIMIT = 50;
 declare const COLLECTION_DEFAULT_OFFSET = 0;
 
 declare const createAIDataResourceEditContextSchema: z.ZodObject<{
-    /**
-     * The the data type of the data resource being edited (merged with its data source)
-     * NOTE: this can contain secrets, API keys, etc. Do not directly expose it to the AI agent!
-     * NOTE: this does not include the current value's variables, if any
-     */
     mergedDataType: z.ZodCustom<MergedDataType, MergedDataType>;
-    /** Which data source variant is currently active (undefined = published data) */
     dataSourceVariant: z.ZodOptional<z.ZodCustom<"unpublished", "unpublished">>;
-    /** The edit request details */
     editRequest: z.ZodObject<{
         edit: z.ZodString;
         currentValue: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     }, z.core.$strip>;
-    /** AI invocation context */
     invocationContext: z.ZodEnum<{
         composition: "composition";
         compositionPattern: "compositionPattern";
@@ -421,9 +440,7 @@ declare const createAIDataResourceEditContextSchema: z.ZodObject<{
         entryPattern: "entryPattern";
         general: "general";
     }>;
-    /** User ID making the edit */
     userId: z.ZodString;
-    /** Project ID */
     projectId: z.ZodString;
 }, z.core.$strict>;
 type CreateAIDataResourceEditContext = z.infer<typeof createAIDataResourceEditContextSchema>;
@@ -551,6 +568,14 @@ type PreRequestEdgehancerDataResourceContext = {
      * The data resource definition that will be requested.
      */
     dataResource: EdgehancerMergedDataType;
+    /**
+     * The set of bindings in the originating composition/entry that consume this
+     * data resource. This can be used to derive a data projection to the target API.
+     *
+     * Undefined for editor / authoring fetches so the editor can read every
+     * field to create new bindings. Never an empty array — unused data resources are automatically skipped from being fetched.
+     */
+    bindings?: readonly CollectedBinding[];
 };
 type PreRequestEdgehancerContext = {
     fetchContext: DataResourceFetchContext;
@@ -761,4 +786,4 @@ declare function getDataResourceQueryString({ parameters, url }: EdgehancerMerge
 /** Gets the HTTP headers for a data resource */
 declare function getDataResourceHeaders({ headers }: EdgehancerMergedDataType): Headers;
 
-export { type AfterAIDataResourceEditContext, type AfterAIDataResourceEditHookFn, type AfterAIDataResourceEditResult, type AfterAIEditContext, type AfterAIEditHookFn, type AfterAIEditResult, COLLECTION_DEFAULT_LIMIT, COLLECTION_DEFAULT_OFFSET, COLLECTION_MAX_LIMIT, type ConvertBatchResultsToEdgehancerResultOptions, type CreateAIDataResourceEditContext, type CreateAIDataResourceEditHookFn, type CreateAIDataResourceEditResult, type CreateAIEditContext, type CreateAIEditHookFn, type CreateAIEditResult, type CustomEdgehancerDefinition, type DataResource, type DataResourceFetchContext, type EdgehancerDataIssue, type EdgehancerMergedDataType, type MergedDataType, type PreRequestEdgehancerContext, type PreRequestEdgehancerDataResourceContext, type PreRequestEdgehancerDataResourceResult, type PreRequestEdgehancerResult, type PreRequestHookFn, type RequestEdgehancerContext, type RequestEdgehancerDataResourceContext, type RequestEdgehancerDataResourceResolutionResult, type RequestEdgehancerResult, type RequestHookFn, type ResolveBatchIdsResult, afterAIDataResourceEditContextSchema, afterAIDataResourceEditResultSchema, afterAIEditContextSchema, afterAIEditResultSchema, convertBatchResultsToEdgehancerResult, createAIDataResourceEditContextSchema, createAIDataResourceEditResultSchema, createAIEditContextSchema, createAIEditResultSchema, dataResourceSchema, edgehancerMergedDataTypeSchema, getDataResourceAsRequest, getDataResourceHeaders, getDataResourceQueryString, getDataResourceUrl, mergedDataTypeSchema, preRequestEdgehancerDataResourceResultSchema, preRequestEdgehancerResultSchema, requestEdgehancerDataResourceResolutionResultSchema, requestEdgehancerResultSchema, resolveBatchFetchIds, resolvingIssueSchema };
+export { type AfterAIDataResourceEditContext, type AfterAIDataResourceEditHookFn, type AfterAIDataResourceEditResult, type AfterAIEditContext, type AfterAIEditHookFn, type AfterAIEditResult, COLLECTION_DEFAULT_LIMIT, COLLECTION_DEFAULT_OFFSET, COLLECTION_MAX_LIMIT, type CollectedBinding, type ConvertBatchResultsToEdgehancerResultOptions, type CreateAIDataResourceEditContext, type CreateAIDataResourceEditHookFn, type CreateAIDataResourceEditResult, type CreateAIEditContext, type CreateAIEditHookFn, type CreateAIEditResult, type CustomEdgehancerDefinition, type DataResource, type DataResourceFetchContext, type EdgehancerDataIssue, type EdgehancerMergedDataType, type MergedDataType, type PreRequestEdgehancerContext, type PreRequestEdgehancerDataResourceContext, type PreRequestEdgehancerDataResourceResult, type PreRequestEdgehancerResult, type PreRequestHookFn, type RequestEdgehancerContext, type RequestEdgehancerDataResourceContext, type RequestEdgehancerDataResourceResolutionResult, type RequestEdgehancerResult, type RequestHookFn, type ResolveBatchIdsResult, afterAIDataResourceEditContextSchema, afterAIDataResourceEditResultSchema, afterAIEditContextSchema, afterAIEditResultSchema, convertBatchResultsToEdgehancerResult, createAIDataResourceEditContextSchema, createAIDataResourceEditResultSchema, createAIEditContextSchema, createAIEditResultSchema, dataResourceSchema, edgehancerMergedDataTypeSchema, getDataResourceAsRequest, getDataResourceHeaders, getDataResourceQueryString, getDataResourceUrl, mergedDataTypeSchema, preRequestEdgehancerDataResourceResultSchema, preRequestEdgehancerResultSchema, requestEdgehancerDataResourceResolutionResultSchema, requestEdgehancerResultSchema, resolveBatchFetchIds, resolvingIssueSchema };

package/dist/index.js

@@ -28,8 +28,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
-var src_exports = {};
-__export(src_exports, {
+var index_exports = {};
+__export(index_exports, {
   COLLECTION_DEFAULT_LIMIT: () => COLLECTION_DEFAULT_LIMIT,
   COLLECTION_DEFAULT_OFFSET: () => COLLECTION_DEFAULT_OFFSET,
   COLLECTION_MAX_LIMIT: () => COLLECTION_MAX_LIMIT,
@@ -56,7 +56,7 @@ __export(src_exports, {
   resolveBatchFetchIds: () => resolveBatchFetchIds,
   resolvingIssueSchema: () => resolvingIssueSchema
 });
-module.exports = __toCommonJS(src_exports);
+module.exports = __toCommonJS(index_exports);
 
 // ../../lib/ai-sdk/src/InvocationContexts.ts
 var z = __toESM(require("zod"), 1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniformdev/mesh-edgehancer-sdk",
-  "version": "20.50.2-alpha.146+88f341e03e",
+  "version": "20.50.2-alpha.167+74e60d5bb7",
   "description": "Uniform Mesh Edgehancer SDK",
   "license": "SEE LICENSE IN LICENSE.txt",
   "main": "./dist/index.js",
@@ -47,12 +47,12 @@
     "/dist"
   ],
   "dependencies": {
-    "@uniformdev/canvas": "20.50.2-alpha.146+88f341e03e",
-    "tsafe": "1.6.6",
-    "zod": "4.3.6"
+    "@uniformdev/canvas": "20.50.2-alpha.167+74e60d5bb7",
+    "tsafe": "1.8.12",
+    "zod": "^4.4.3"
   },
   "devDependencies": {
-    "next": "16.2.3"
+    "next": "16.2.9"
   },
   "peerDependencies": {
     "next": ">13"
@@ -60,5 +60,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "88f341e03ec871c6af2cd47b9ce257ff4a394816"
+  "gitHead": "74e60d5bb79fe1c4d446e4d3e6edf9f08850be4f"
 }