@crossplane-org/function-sdk-typescript 0.4.0 → 0.5.0-20260305214119-9b69c9f3611e

package/dist/request/request.js

@@ -5,7 +5,7 @@
  * including composite resources, composed resources, input configuration, context values,
  * required resources, and credentials.
  */
-import { Credentials, Resource, Resources, RunFunctionRequest } from '../proto/run_function.js';
+import { Capability, Credentials, Resource, Resources, RunFunctionRequest, } from '../proto/run_function.js';
 /**
  * Get the desired composite resource (XR) from the request.
  *
@@ -216,4 +216,216 @@ export function getCredentials(req, name) {
     }
     return creds;
 }
+/**
+ * Get a required resource from the request by name.
+ *
+ * Required resources are resources that the function specified it needs using
+ * response.requireResource. Crossplane fetches the requested resources and includes
+ * them in the next request. The boolean return value indicates whether Crossplane
+ * has resolved the requirement.
+ *
+ * @param req - The RunFunctionRequest containing required resources
+ * @param name - The name of the required resource group to retrieve
+ * @returns A tuple of [resources, resolved]:
+ *   - resources: Array of Resource objects (empty if not found)
+ *   - resolved: true if Crossplane attempted to resolve the requirement, false otherwise
+ *
+ * @example
+ * ```typescript
+ * // After calling requireResource in a previous function invocation:
+ * const [resources, resolved] = getRequiredResource(req, "app-config");
+ * if (!resolved) {
+ *   console.log("Resource requirement not yet resolved by Crossplane");
+ * } else if (resources.length === 0) {
+ *   console.log("Resource requirement resolved but no resources found");
+ * } else {
+ *   console.log("Found resources:", resources);
+ *   resources.forEach(r => console.log(r.resource));
+ * }
+ * ```
+ */
+export function getRequiredResource(req, name) {
+    if (!req.requiredResources) {
+        return [[], false];
+    }
+    const rrs = req.requiredResources[name];
+    if (!rrs) {
+        return [[], false];
+    }
+    const out = [];
+    for (const item of rrs.items || []) {
+        if (!item || !item.resource) {
+            continue;
+        }
+        out.push({
+            resource: item.resource,
+            connectionDetails: item.connectionDetails || {},
+            ready: item.ready || 0,
+        });
+    }
+    return [out, true];
+}
+/**
+ * Get all required schemas from the request.
+ *
+ * Returns all schemas that were requested using response.requireSchema and
+ * resolved by Crossplane. The map key corresponds to the name used in
+ * requireSchema. Each value is the OpenAPI v3 schema as an unstructured object,
+ * or undefined if the schema could not be found.
+ *
+ * @param req - The RunFunctionRequest containing required schemas
+ * @returns A map of schema names to OpenAPI v3 schema objects (or undefined if not found)
+ *
+ * @example
+ * ```typescript
+ * const schemas = getRequiredSchemas(req);
+ * for (const [name, schema] of Object.entries(schemas)) {
+ *   if (schema) {
+ *     console.log(`Schema ${name}:`, schema);
+ *   } else {
+ *     console.log(`Schema ${name} was requested but not found`);
+ *   }
+ * }
+ * ```
+ */
+export function getRequiredSchemas(req) {
+    const out = {};
+    if (!req.requiredSchemas) {
+        return out;
+    }
+    for (const [name, schema] of Object.entries(req.requiredSchemas)) {
+        out[name] = schema?.openapiV3;
+    }
+    return out;
+}
+/**
+ * Get a required schema from the request by name.
+ *
+ * Returns the OpenAPI v3 schema for a resource kind that was requested using
+ * response.requireSchema. The boolean return value indicates whether Crossplane
+ * has resolved the requirement.
+ *
+ * @param req - The RunFunctionRequest containing required schemas
+ * @param name - The name of the required schema to retrieve
+ * @returns A tuple of [schema, resolved]:
+ *   - schema: The OpenAPI v3 schema object, or undefined if not found
+ *   - resolved: true if Crossplane attempted to resolve the requirement, false otherwise
+ *
+ * Note: When resolved is true but schema is undefined, it means Crossplane tried
+ * to find the schema but it doesn't exist for that resource kind.
+ *
+ * @example
+ * ```typescript
+ * // After calling requireSchema in a previous function invocation:
+ * const [schema, resolved] = getRequiredSchema(req, "xr-schema");
+ * if (!resolved) {
+ *   console.log("Schema not yet resolved by Crossplane");
+ * } else if (!schema) {
+ *   console.log("Schema resolved but not found (kind may not exist)");
+ * } else {
+ *   console.log("Schema properties:", schema.properties);
+ *   console.log("Required fields:", schema.required);
+ * }
+ * ```
+ */
+export function getRequiredSchema(req, name) {
+    const schemas = req.requiredSchemas;
+    if (!schemas) {
+        return [undefined, false];
+    }
+    const schema = schemas[name];
+    if (!schema) {
+        return [undefined, false];
+    }
+    return [schema.openapiV3, true];
+}
+/**
+ * Check whether Crossplane advertises its capabilities.
+ *
+ * Crossplane v2.2 and later advertise their capabilities in the request
+ * metadata. If this returns false, the calling Crossplane predates capability
+ * advertisement and hasCapability will always return false, even for features
+ * the older Crossplane does support.
+ *
+ * @param req - The RunFunctionRequest to check
+ * @returns true if Crossplane advertises its capabilities
+ *
+ * @example
+ * ```typescript
+ * if (!advertiseCapabilities(req)) {
+ *   // Pre-v2.2 Crossplane, capabilities are unknown
+ *   console.log("Crossplane version predates capability advertisement");
+ * } else if (hasCapability(req, Capability.CAPABILITY_REQUIRED_SCHEMAS)) {
+ *   requireSchema(rsp, "xr", xrApiVersion, xrKind);
+ * }
+ * ```
+ */
+export function advertiseCapabilities(req) {
+    if (!req.meta?.capabilities) {
+        return false;
+    }
+    return req.meta.capabilities.includes(Capability.CAPABILITY_CAPABILITIES);
+}
+/**
+ * Check whether Crossplane advertises a particular capability.
+ *
+ * Crossplane sends its capabilities in the request metadata. Functions can use
+ * this to determine whether Crossplane will honor certain fields in their
+ * response, or populate certain fields in their request.
+ *
+ * Use advertiseCapabilities to check whether Crossplane advertises its
+ * capabilities at all. If it doesn't, hasCapability always returns false even
+ * for features the older Crossplane does support.
+ *
+ * @param req - The RunFunctionRequest to check
+ * @param cap - The capability to check for (e.g., Capability.CAPABILITY_REQUIRED_SCHEMAS)
+ * @returns true if the capability is present in the request metadata
+ *
+ * @example
+ * ```typescript
+ * import { Capability } from './proto/run_function.js';
+ *
+ * if (hasCapability(req, Capability.CAPABILITY_REQUIRED_SCHEMAS)) {
+ *   requireSchema(rsp, "xr", xrApiVersion, xrKind);
+ * }
+ *
+ * if (hasCapability(req, Capability.CAPABILITY_CONDITIONS)) {
+ *   // Safe to return status conditions
+ *   rsp.conditions = [{ type: "Ready", status: "True" }];
+ * }
+ * ```
+ */
+export function hasCapability(req, cap) {
+    if (!req.meta?.capabilities) {
+        return false;
+    }
+    return req.meta.capabilities.includes(cap);
+}
+/**
+ * Get the watched resource that triggered this operation.
+ *
+ * When a WatchOperation creates an Operation, it injects the resource that
+ * changed using the special requirement name 'ops.crossplane.io/watched-resource'.
+ * This helper makes it easy to access that resource.
+ *
+ * @param req - The RunFunctionRequest to check for a watched resource
+ * @returns The watched resource object, or undefined if not found
+ *
+ * @example
+ * ```typescript
+ * // In an operation function triggered by a WatchOperation
+ * const watched = getWatchedResource(req);
+ * if (watched) {
+ *   console.log("Operation triggered by change to:", watched.metadata?.name);
+ *   console.log("Resource kind:", watched.kind);
+ * }
+ * ```
+ */
+export function getWatchedResource(req) {
+    const [resources, resolved] = getRequiredResource(req, 'ops.crossplane.io/watched-resource');
+    if (!resolved || resources.length === 0) {
+        return undefined;
+    }
+    return resources[0].resource;
+}
 //# sourceMappingURL=request.js.map

package/dist/request/request.js.map

@@ -1 +1 @@
-{"version":3,"file":"request.js","sourceRoot":"","sources":["../../src/request/request.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEhG;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,2BAA2B,CAAC,GAAuB;IACjE,OAAO,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC;AAChC,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,4BAA4B,CAAC,GAAuB;IAClE,OAAO,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,2BAA2B,CAAC,GAAuB;IACjE,IAAI,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC;QAC3B,OAAO,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC;IAChC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,4BAA4B,CAAC,GAAuB;IAClE,IAAI,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC;QAC5B,OAAO,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC;IACjC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAuB;IAC9C,OAAO,GAAG,CAAC,KAAK,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,aAAa,CAAC,GAAuB,EAAE,GAAW;IAChE,IAAI,GAAG,CAAC,OAAO,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAuB;IAC1D,OAAO,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC;AACrC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAuB;IACvD,OAAO,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,cAAc,CAAC,GAAuB,EAAE,IAAY;IAClE,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,aAAa,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../src/request/request.ts"],"names":[],"mappings":"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"}

package/dist/resource/resource.d.ts

@@ -2,6 +2,33 @@ import { Ready, Resource } from '../proto/run_function.js';
 export type ConnectionDetails = {
     [key: string]: Buffer;
 };
+/**
+ * Condition represents a status condition of a Kubernetes resource
+ */
+export interface Condition {
+    /** Type of the condition - e.g. Ready, Synced */
+    type: string;
+    /** Status of the condition - True, False, or Unknown */
+    status: string;
+    /** Reason for the condition status - typically CamelCase */
+    reason?: string;
+    /** Optional message providing details about the condition */
+    message?: string;
+    /** The last time the condition transitioned to this status */
+    lastTransitionTime?: string;
+}
+/**
+ * Options for controlling merge behavior when updating resources
+ */
+export interface MergeOptions {
+    /**
+     * Whether to merge arrays by concatenation (true) or replace them (false).
+     * Default is false.
+     *
+     * @default false
+     */
+    mergeArrays?: boolean;
+}
 /**
  * Composite represents a Crossplane composite resource (XR) with its state
  */
@@ -128,4 +155,90 @@ export declare function toObject(resource: Resource): Record<string, unknown> |
 export declare function fromModel<T extends Record<string, unknown>>(obj: {
     toJSON: () => T;
 }, connectionDetails?: ConnectionDetails, ready?: Ready): Resource;
+/**
+ * Update a Resource by merging a source into it.
+ *
+ * This function performs a deep merge of the source object into the target Resource,
+ * allowing you to update specific fields while preserving others. The source can be
+ * a plain JavaScript object, a protobuf Struct (Record<string, unknown>), or a
+ * Resource object.
+ *
+ * The merge semantics match the Python SDK's behavior (similar to a dictionary's
+ * update method): fields that don't exist will be added, and fields that exist will
+ * be overwritten. By default, arrays are replaced rather than concatenated to match
+ * Python SDK behavior.
+ *
+ * @param r - The Resource to update
+ * @param source - The source data to merge (plain object, Struct, or Resource)
+ * @param options - Optional merge configuration (default: { mergeArrays: false })
+ *
+ * @example
+ * ```typescript
+ * const bucket = getDesiredComposedResources(req)["my-bucket"];
+ * if (bucket) {
+ *   // Update specific fields while preserving others
+ *   // Arrays are replaced by default (Python SDK behavior)
+ *   update(bucket, {
+ *     resource: {
+ *       spec: {
+ *         forProvider: {
+ *           region: "us-west-2",
+ *           tags: ["env:prod", "team:platform"]  // Replaces existing tags
+ *         }
+ *       }
+ *     }
+ *   });
+ * }
+ *
+ * // Optionally concatenate arrays instead of replacing them
+ * update(bucket, {
+ *   resource: {
+ *     spec: {
+ *       forProvider: {
+ *         tags: ["new-tag"]  // Will be appended to existing tags
+ *       }
+ *     }
+ *   }
+ * }, { mergeArrays: true });
+ *
+ * // You can also merge from another Resource
+ * const template = Resource.fromJSON({ resource: templateConfig });
+ * update(bucket, template);
+ * ```
+ */
+export declare function update(r: Resource, source: Record<string, unknown> | Resource, options?: MergeOptions): void;
+/**
+ * Get a status condition from a Kubernetes resource.
+ *
+ * This function extracts a specific status condition from a resource by type.
+ * Status conditions follow the Kubernetes standard pattern and are typically
+ * found in the resource's status.conditions array.
+ *
+ * @param resource - A Kubernetes resource object (plain JavaScript object)
+ * @param type - The type of status condition to get (e.g., "Ready", "Synced")
+ * @returns The requested status condition, or a condition with status "Unknown" if not found
+ *
+ * @example
+ * ```typescript
+ * const oxr = getObservedCompositeResource(req);
+ * if (oxr?.resource) {
+ *   const readyCondition = getCondition(oxr.resource, "Ready");
+ *   if (readyCondition.status === "True") {
+ *     console.log("Resource is ready");
+ *   } else if (readyCondition.status === "False") {
+ *     console.log("Resource not ready:", readyCondition.message);
+ *   } else {
+ *     console.log("Ready status unknown");
+ *   }
+ * }
+ *
+ * // Check if a composed resource is synced
+ * const bucket = observedResources["my-bucket"];
+ * if (bucket?.resource) {
+ *   const synced = getCondition(bucket.resource, "Synced");
+ *   console.log("Sync status:", synced.status, synced.reason);
+ * }
+ * ```
+ */
+export declare function getCondition(resource: Record<string, unknown> | undefined, type: string): Condition;
 //# sourceMappingURL=resource.d.ts.map

package/dist/resource/resource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../src/resource/resource.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAG3D,MAAM,MAAM,iBAAiB,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,QAAQ,CAAC;IACnB,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,KAAK,EAAE,KAAK,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,iBAAiB,EAAE,iBAAiB,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAKpD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQ7F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAI9E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUtF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASpE;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,iBAAiB,CAAC,EAAE,iBAAiB,EACrC,KAAK,CAAC,EAAE,KAAK,GACZ,QAAQ,CAMV;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAEhF;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzD,GAAG,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,EACxB,iBAAiB,CAAC,EAAE,iBAAiB,EACrC,KAAK,CAAC,EAAE,KAAK,GACZ,QAAQ,CAEV"}
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../src/resource/resource.ts"],"names":[],"mappings":"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"}

package/dist/resource/resource.js

@@ -1,5 +1,6 @@
 // Resource utilities for working with Kubernetes resources and protobuf conversion
 import { Ready, Resource } from '../proto/run_function.js';
+import { merge } from 'ts-deepmerge';
 /**
  * Create a new empty DesiredComposed resource
  */
@@ -141,6 +142,178 @@ export function toObject(resource) {
  * ```
  */
 export function fromModel(obj, connectionDetails, ready) {
+    // T already extends Record<string, unknown>, so the cast is unnecessary.
+    // Pass the result directly to fromObject which accepts T via its signature.
     return fromObject(obj.toJSON(), connectionDetails, ready);
 }
+/**
+ * Update a Resource by merging a source into it.
+ *
+ * This function performs a deep merge of the source object into the target Resource,
+ * allowing you to update specific fields while preserving others. The source can be
+ * a plain JavaScript object, a protobuf Struct (Record<string, unknown>), or a
+ * Resource object.
+ *
+ * The merge semantics match the Python SDK's behavior (similar to a dictionary's
+ * update method): fields that don't exist will be added, and fields that exist will
+ * be overwritten. By default, arrays are replaced rather than concatenated to match
+ * Python SDK behavior.
+ *
+ * @param r - The Resource to update
+ * @param source - The source data to merge (plain object, Struct, or Resource)
+ * @param options - Optional merge configuration (default: { mergeArrays: false })
+ *
+ * @example
+ * ```typescript
+ * const bucket = getDesiredComposedResources(req)["my-bucket"];
+ * if (bucket) {
+ *   // Update specific fields while preserving others
+ *   // Arrays are replaced by default (Python SDK behavior)
+ *   update(bucket, {
+ *     resource: {
+ *       spec: {
+ *         forProvider: {
+ *           region: "us-west-2",
+ *           tags: ["env:prod", "team:platform"]  // Replaces existing tags
+ *         }
+ *       }
+ *     }
+ *   });
+ * }
+ *
+ * // Optionally concatenate arrays instead of replacing them
+ * update(bucket, {
+ *   resource: {
+ *     spec: {
+ *       forProvider: {
+ *         tags: ["new-tag"]  // Will be appended to existing tags
+ *       }
+ *     }
+ *   }
+ * }, { mergeArrays: true });
+ *
+ * // You can also merge from another Resource
+ * const template = Resource.fromJSON({ resource: templateConfig });
+ * update(bucket, template);
+ * ```
+ */
+export function update(r, source, options) {
+    if (!r.resource) {
+        r.resource = {};
+    }
+    // Default to Python SDK behavior: replace arrays rather than concatenating
+    const mergeArrays = options?.mergeArrays ?? false;
+    // Detect genuine protobuf `Resource` instances by checking for protobuf-specific fields
+    // (the generated Resource interface includes `connectionDetails` and `ready`).
+    const isProtoResource = typeof source === 'object' &&
+        source !== null &&
+        'resource' in source &&
+        typeof source.resource === 'object' &&
+        ('connectionDetails' in source || 'ready' in source);
+    let sourceData;
+    if (isProtoResource) {
+        // Unwrap only genuine protobuf Resource instances
+        sourceData = source.resource ?? {};
+    }
+    else {
+        // Treat as plain object. If it has a top-level `resource` object (but isn't a
+        // protobuf Resource), merge both the `resource` field and any top-level
+        // `metadata` into the resource data so callers that pass plain objects keep
+        // expected semantics.
+        const srcObj = source;
+        if (srcObj &&
+            'resource' in srcObj &&
+            typeof srcObj.resource === 'object' &&
+            srcObj.resource !== null &&
+            !Array.isArray(srcObj.resource)) {
+            const resourcePart = srcObj.resource;
+            if ('metadata' in srcObj &&
+                typeof srcObj.metadata === 'object' &&
+                srcObj.metadata !== null &&
+                !Array.isArray(srcObj.metadata)) {
+                sourceData = merge.withOptions({ mergeArrays }, resourcePart, {
+                    metadata: srcObj.metadata,
+                });
+            }
+            else {
+                sourceData = resourcePart;
+            }
+        }
+        else {
+            sourceData = srcObj;
+        }
+    }
+    // Perform deep merge with configured array handling
+    r.resource = merge.withOptions({ mergeArrays }, r.resource, sourceData);
+}
+/**
+ * Get a status condition from a Kubernetes resource.
+ *
+ * This function extracts a specific status condition from a resource by type.
+ * Status conditions follow the Kubernetes standard pattern and are typically
+ * found in the resource's status.conditions array.
+ *
+ * @param resource - A Kubernetes resource object (plain JavaScript object)
+ * @param type - The type of status condition to get (e.g., "Ready", "Synced")
+ * @returns The requested status condition, or a condition with status "Unknown" if not found
+ *
+ * @example
+ * ```typescript
+ * const oxr = getObservedCompositeResource(req);
+ * if (oxr?.resource) {
+ *   const readyCondition = getCondition(oxr.resource, "Ready");
+ *   if (readyCondition.status === "True") {
+ *     console.log("Resource is ready");
+ *   } else if (readyCondition.status === "False") {
+ *     console.log("Resource not ready:", readyCondition.message);
+ *   } else {
+ *     console.log("Ready status unknown");
+ *   }
+ * }
+ *
+ * // Check if a composed resource is synced
+ * const bucket = observedResources["my-bucket"];
+ * if (bucket?.resource) {
+ *   const synced = getCondition(bucket.resource, "Synced");
+ *   console.log("Sync status:", synced.status, synced.reason);
+ * }
+ * ```
+ */
+export function getCondition(resource, type) {
+    const unknown = { type, status: 'Unknown' };
+    if (!resource || !('status' in resource)) {
+        return unknown;
+    }
+    const status = resource.status;
+    if (!status || !('conditions' in status)) {
+        return unknown;
+    }
+    const conditions = status.conditions;
+    if (!Array.isArray(conditions)) {
+        return unknown;
+    }
+    for (const c of conditions) {
+        if (c.type !== type) {
+            continue;
+        }
+        const condition = {
+            type: String(c.type),
+            status: String(c.status),
+        };
+        if (c.message !== undefined && c.message !== null) {
+            condition.message = typeof c.message === 'string' ? c.message : JSON.stringify(c.message);
+        }
+        if (c.reason !== undefined && c.reason !== null) {
+            condition.reason = typeof c.reason === 'string' ? c.reason : JSON.stringify(c.reason);
+        }
+        if (c.lastTransitionTime !== undefined && c.lastTransitionTime !== null) {
+            condition.lastTransitionTime =
+                typeof c.lastTransitionTime === 'string'
+                    ? c.lastTransitionTime
+                    : JSON.stringify(c.lastTransitionTime);
+        }
+        return condition;
+    }
+    return unknown;
+}
 //# sourceMappingURL=resource.js.map

package/dist/resource/resource.js.map

@@ -1 +1 @@
-{"version":3,"file":"resource.js","sourceRoot":"","sources":["../../src/resource/resource.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AA8B3D;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,KAAK,EAAE,KAAK,CAAC,iBAAiB;KAC/B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,QAAQ,CAAC,MAA2C;IAClE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,wEAAwE;IACxE,sDAAsD;IACtD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,QAAQ,CAAC,GAA4B;IACnD,uEAAuE;IACvE,oEAAoE;IACpE,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAA4B;IAC3D,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,uCACE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,EAAE,CACH,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4B,CAAC;QACxD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,mCAAmC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC5F,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CACxB,GAA4B,EAC5B,iBAAqC,EACrC,KAAa;IAEb,OAAO,QAAQ,CAAC,QAAQ,CAAC;QACvB,QAAQ,EAAE,GAAG;QACb,iBAAiB,EAAE,iBAAiB,IAAI,EAAE;QAC1C,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,iBAAiB;KAC7D,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAkB;IACzC,OAAO,QAAQ,CAAC,QAAQ,CAAC;AAC3B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,SAAS,CACvB,GAAwB,EACxB,iBAAqC,EACrC,KAAa;IAEb,OAAO,UAAU,CAAC,GAAG,CAAC,MAAM,EAA6B,EAAE,iBAAiB,EAAE,KAAK,CAAC,CAAC;AACvF,CAAC"}
+{"version":3,"file":"resource.js","sourceRoot":"","sources":["../../src/resource/resource.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AA2DrC;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,KAAK,EAAE,KAAK,CAAC,iBAAiB;KAC/B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,QAAQ,CAAC,MAA2C;IAClE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,wEAAwE;IACxE,sDAAsD;IACtD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,QAAQ,CAAC,GAA4B;IACnD,uEAAuE;IACvE,oEAAoE;IACpE,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAA4B;IAC3D,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,uCACE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,EAAE,CACH,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4B,CAAC;QACxD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,mCAAmC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC5F,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CACxB,GAA4B,EAC5B,iBAAqC,EACrC,KAAa;IAEb,OAAO,QAAQ,CAAC,QAAQ,CAAC;QACvB,QAAQ,EAAE,GAAG;QACb,iBAAiB,EAAE,iBAAiB,IAAI,EAAE;QAC1C,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,iBAAiB;KAC7D,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAkB;IACzC,OAAO,QAAQ,CAAC,QAAQ,CAAC;AAC3B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,SAAS,CACvB,GAAwB,EACxB,iBAAqC,EACrC,KAAa;IAEb,yEAAyE;IACzE,4EAA4E;IAC5E,OAAO,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,iBAAiB,EAAE,KAAK,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,MAAM,UAAU,MAAM,CACpB,CAAW,EACX,MAA0C,EAC1C,OAAsB;IAEtB,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAChB,CAAC,CAAC,QAAQ,GAAG,EAAE,CAAC;IAClB,CAAC;IAED,2EAA2E;IAC3E,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,KAAK,CAAC;IAElD,wFAAwF;IACxF,+EAA+E;IAC/E,MAAM,eAAe,GACnB,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,UAAU,IAAI,MAAM;QACpB,OAAQ,MAAiC,CAAC,QAAQ,KAAK,QAAQ;QAC/D,CAAC,mBAAmB,IAAI,MAAM,IAAI,OAAO,IAAI,MAAM,CAAC,CAAC;IAEvD,IAAI,UAAmC,CAAC;IAExC,IAAI,eAAe,EAAE,CAAC;QACpB,kDAAkD;QAClD,UAAU,GAAI,MAAmB,CAAC,QAAQ,IAAI,EAAE,CAAC;IACnD,CAAC;SAAM,CAAC;QACN,8EAA8E;QAC9E,wEAAwE;QACxE,4EAA4E;QAC5E,sBAAsB;QACtB,MAAM,MAAM,GAAG,MAAiC,CAAC;QACjD,IACE,MAAM;YACN,UAAU,IAAI,MAAM;YACpB,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ;YACnC,MAAM,CAAC,QAAQ,KAAK,IAAI;YACxB,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAC/B,CAAC;YACD,MAAM,YAAY,GAAG,MAAM,CAAC,QAAmC,CAAC;YAChE,IACE,UAAU,IAAI,MAAM;gBACpB,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ;gBACnC,MAAM,CAAC,QAAQ,KAAK,IAAI;gBACxB,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAC/B,CAAC;gBACD,UAAU,GAAG,KAAK,CAAC,WAAW,CAAC,EAAE,WAAW,EAAE,EAAE,YAAY,EAAE;oBAC5D,QAAQ,EAAE,MAAM,CAAC,QAAQ;iBAC1B,CAA4B,CAAC;YAChC,CAAC;iBAAM,CAAC;gBACN,UAAU,GAAG,YAAY,CAAC;YAC5B,CAAC;QACH,CAAC;aAAM,CAAC;YACN,UAAU,GAAG,MAAM,CAAC;QACtB,CAAC;IACH,CAAC;IAED,oDAAoD;IACpD,CAAC,CAAC,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,UAAU,CAGrE,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,YAAY,CAC1B,QAA6C,EAC7C,IAAY;IAEZ,MAAM,OAAO,GAAc,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAEvD,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,IAAI,QAAQ,CAAC,EAAE,CAAC;QACzC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,MAA6C,CAAC;IACtE,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,YAAY,IAAI,MAAM,CAAC,EAAE,CAAC;QACzC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,UAAwD,CAAC;IACnF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACpB,SAAS;QACX,CAAC;QAED,MAAM,SAAS,GAAc;YAC3B,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;YACpB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;SACzB,CAAC;QAEF,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAClD,SAAS,CAAC,OAAO,GAAG,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAC5F,CAAC;QACD,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAChD,SAAS,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACxF,CAAC;QACD,IAAI,CAAC,CAAC,kBAAkB,KAAK,SAAS,IAAI,CAAC,CAAC,kBAAkB,KAAK,IAAI,EAAE,CAAC;YACxE,SAAS,CAAC,kBAAkB;gBAC1B,OAAO,CAAC,CAAC,kBAAkB,KAAK,QAAQ;oBACtC,CAAC,CAAC,CAAC,CAAC,kBAAkB;oBACtB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/response/response.d.ts

@@ -5,7 +5,7 @@
  * including setting desired state, managing results, handling context, and working with
  * composite resources and their status.
  */
-import { Resource, RunFunctionRequest, RunFunctionResponse, Ready } from '../proto/run_function.js';
+import { Resource, RunFunctionRequest, RunFunctionResponse, Ready, ResourceSelector } from '../proto/run_function.js';
 import { Duration } from '../proto/google/protobuf/duration.js';
 /**
  * Default time-to-live for function responses (60 seconds).
@@ -300,4 +300,81 @@ export declare function setDesiredCompositeResource(rsp: RunFunctionResponse, re
  * ```
  */
 export declare function setOutput(rsp: RunFunctionResponse, output: Record<string, unknown>): RunFunctionResponse;
+/**
+ * Add a schema requirement to the response.
+ *
+ * This tells Crossplane to fetch the OpenAPI schema for the specified resource kind
+ * and include it in the next request's required_schemas field. Use request.getRequiredSchema
+ * to retrieve the resolved schema.
+ *
+ * For CRDs, Crossplane returns the spec.versions[].schema.openAPIV3Schema field.
+ * If Crossplane cannot find a schema for the requested kind, the schema will be
+ * empty (getRequiredSchema will return undefined with resolved true).
+ *
+ * @param rsp - The RunFunctionResponse to update
+ * @param name - A unique name to identify this schema requirement
+ * @param apiVersion - API version of the resource kind (e.g., "example.org/v1")
+ * @param kind - Kind of resource (e.g., "MyResource")
+ * @returns The updated response
+ *
+ * @example
+ * ```typescript
+ * // Request the OpenAPI schema for an XR type
+ * rsp = requireSchema(rsp, "xr-schema", "example.org/v1", "MyResource");
+ *
+ * // In the next function invocation, retrieve the schema:
+ * const [schema, ok] = getRequiredSchema(req, "xr-schema");
+ * if (ok && schema) {
+ *   console.log("Schema properties:", schema.properties);
+ * }
+ * ```
+ */
+export declare function requireSchema(rsp: RunFunctionResponse, name: string, apiVersion: string, kind: string): RunFunctionResponse;
+/**
+ * Add a resource requirement to the response.
+ *
+ * This tells Crossplane to fetch resources matching the selector and include them
+ * in the next request's required_resources field. Use request.getRequiredResource
+ * to retrieve the resolved resources.
+ *
+ * The selector can match resources by name or by labels. If namespace is omitted,
+ * cluster-scoped resources are matched, or namespaced resources across all namespaces
+ * when matching by labels.
+ *
+ * @param rsp - The RunFunctionResponse to update
+ * @param name - A unique name to identify this resource requirement
+ * @param selector - The resource selector specifying which resources to fetch
+ * @returns The updated response
+ *
+ * @example
+ * ```typescript
+ * // Match a specific ConfigMap by name
+ * rsp = requireResource(rsp, "app-config", {
+ *   apiVersion: "v1",
+ *   kind: "ConfigMap",
+ *   matchName: "my-app-config",
+ *   namespace: "production"
+ * });
+ *
+ * // Match all Secrets with specific labels
+ * rsp = requireResource(rsp, "db-secrets", {
+ *   apiVersion: "v1",
+ *   kind: "Secret",
+ *   matchLabels: {
+ *     labels: {
+ *       app: "database",
+ *       tier: "backend"
+ *     }
+ *   },
+ *   namespace: "production"
+ * });
+ *
+ * // In the next function invocation, retrieve the resources:
+ * const [resources, resolved, error] = getRequiredResource(req, "app-config");
+ * if (resolved && !error && resources.length > 0) {
+ *   console.log("Found config:", resources[0].resource);
+ * }
+ * ```
+ */
+export declare function requireResource(rsp: RunFunctionResponse, name: string, selector: ResourceSelector): RunFunctionResponse;
 //# sourceMappingURL=response.d.ts.map