@rippling/rippling-sdk 0.2.0-alpha.100

package/core/platform/custom-objects/provisioning.mjs

@@ -0,0 +1,447 @@
+import { provisionCustomObjectCategoryDefinition } from "./category.mjs";
+/**
+ * Returns whether one field references another object and therefore benefits from being created after scalar fields.
+ *
+ * @param field - Typed field definition to inspect.
+ * @returns Whether the field is a lookup or parent-child relationship.
+ */
+function isRelationshipField(field) {
+    return field.kind === 'lookup' || field.kind === 'parent-child';
+}
+/**
+ * Returns whether one field uses a formula-field variant.
+ *
+ * @param field - Typed field definition to inspect.
+ * @returns Whether the field is one of the `formula-*` kinds.
+ */
+function isFormulaField(field) {
+    return field.kind.startsWith('formula-');
+}
+/**
+ * Builds the wire-level `data_type` payload expected by the custom-object field REST API.
+ *
+ * @param field - Typed field definition to compile.
+ * @returns REST `data_type` payload for the supplied field definition.
+ */
+function buildFieldDataType(field) {
+    switch (field.kind) {
+        case 'text':
+            return {
+                field_type: 'TEXT',
+                ...(field.maxLength != null ? { max_length: field.maxLength } : {}),
+            };
+        case 'long-text':
+            return {
+                field_type: 'LONG_TEXT',
+                ...(field.maxLength != null ? { max_length: field.maxLength } : {}),
+            };
+        case 'email':
+            return { field_type: 'EMAIL' };
+        case 'url':
+            return { field_type: 'URL' };
+        case 'phone':
+            return { field_type: 'PHONE_NUMBER' };
+        case 'number':
+            return {
+                field_type: 'NUMBER',
+                ...(field.decimalPlaces != null ? { num_of_decimal_places: field.decimalPlaces } : {}),
+            };
+        case 'currency':
+            return {
+                field_type: 'CURRENCY',
+                ...(field.currency != null ? { currency: field.currency } : {}),
+                ...(field.decimalPlaces != null ? { num_of_decimal_places: field.decimalPlaces } : {}),
+            };
+        case 'percentage':
+            return { field_type: 'PERCENTAGE', num_of_decimal_places: 2 };
+        case 'date':
+            return { field_type: 'DATE' };
+        case 'datetime':
+            return { field_type: 'DATETIME' };
+        case 'time':
+            return { field_type: 'TIME' };
+        case 'select':
+            return { field_type: 'SELECT', options_list: [...field.options] };
+        case 'radio':
+            return { field_type: 'RADIO', options_list: [...field.options] };
+        case 'boolean':
+            return { field_type: 'BOOLEAN' };
+        case 'file':
+            return {
+                field_type: 'FILE',
+                supported_types: field.allowedType === 'any' ? ['*'] : [field.allowedType],
+            };
+        case 'lookup':
+            return {
+                field_type: 'OG_REFERENCE_FIELD',
+                og_model_rql_name: field.target.apiName,
+                edge_type: 'LOOKUP',
+                ...(field.relatedDataLabel != null ? { related_data_label: field.relatedDataLabel } : {}),
+                ...(field.lookupFilterRqlCondition != null ?
+                    { lookup_filter_rql_condition: field.lookupFilterRqlCondition }
+                    : {}),
+            };
+        case 'parent-child':
+            return {
+                field_type: 'OG_REFERENCE_FIELD',
+                og_model_rql_name: field.target.apiName,
+                edge_type: 'PARENT_CHILD',
+                ...(field.relatedDataLabel != null ? { related_data_label: field.relatedDataLabel } : {}),
+                ...(field.parentChildType != null ? { parent_child_type: field.parentChildType } : {}),
+                ...(field.enableParentOwnerInheritance != null ?
+                    { enable_parent_owner_inheritance: field.enableParentOwnerInheritance }
+                    : {}),
+            };
+        case 'formula-text':
+            return { field_type: 'TEXT', ...(field.maxLength != null ? { max_length: field.maxLength } : {}) };
+        case 'formula-number':
+            return { field_type: 'NUMBER' };
+        case 'formula-boolean':
+            return { field_type: 'BOOLEAN' };
+        case 'formula-currency':
+            return { field_type: 'CURRENCY' };
+        case 'formula-percentage':
+            return { field_type: 'PERCENTAGE' };
+        case 'formula-date':
+            return { field_type: 'DATE' };
+        case 'formula-url':
+            return { field_type: 'URL' };
+    }
+}
+/**
+ * Builds REST section metadata for one typed field definition.
+ *
+ * @param definition - Object definition that owns the field and section map.
+ * @param field - Typed field definition whose section metadata should be compiled.
+ * @returns Concrete section id string expected by the live REST API, when available.
+ * @throws Error when REST provisioning would require a section id that cannot be resolved.
+ * @typeParam TDefinition - Object definition that owns the field.
+ */
+function buildFieldSection(definition, field) {
+    const sectionKey = field.section;
+    const sectionOverride = field.restSection;
+    const overrideSectionId = typeof sectionOverride === 'string' ? sectionOverride : sectionOverride?.section_id;
+    if (sectionKey == null) {
+        if (sectionOverride == null)
+            return undefined;
+        if (overrideSectionId == null) {
+            throw new Error('REST field provisioning currently requires a concrete section id string.');
+        }
+        return overrideSectionId;
+    }
+    const sections = definition.sections;
+    const sectionDefinition = sections[sectionKey];
+    if (sectionDefinition == null)
+        return overrideSectionId;
+    const resolvedSectionId = overrideSectionId ?? sectionDefinition.sectionId;
+    if (resolvedSectionId == null) {
+        throw new Error(`Field section "${sectionKey}" for "${definition.name}" requires a sectionId for REST provisioning.`);
+    }
+    return resolvedSectionId;
+}
+/**
+ * Builds name-field metadata for REST field updates when the object uses autonumber names.
+ *
+ * @param definition - Typed object definition whose name-field metadata should be compiled.
+ * @returns Name-field metadata payload for the platform-managed `name` field, when needed.
+ * @typeParam TDefinition - Object definition being compiled.
+ */
+export function buildCustomObjectNameFieldDetails(definition) {
+    if (definition.nameField.kind !== 'autonumber')
+        return undefined;
+    return {
+        is_autonumber_field: true,
+        autonumber_format: definition.nameField.format,
+        ...(definition.nameField.startingNumber != null ?
+            { starting_number: definition.nameField.startingNumber }
+            : {}),
+    };
+}
+/**
+ * Builds the object-creation payload for the low-level REST API using a resolved category id.
+ *
+ * @param definition - Typed object definition to compile.
+ * @param categoryIdentifier - Resolved custom-category id or native category id required by the live API.
+ * @returns REST object-create payload.
+ * @typeParam TDefinition - Object definition being compiled.
+ */
+export function buildCustomObjectCreateParams(definition, categoryIdentifier) {
+    return {
+        category: categoryIdentifier,
+        description: definition.description,
+        name: definition.name,
+    };
+}
+/**
+ * Builds the object-update payload used to restore human-facing labels after creation.
+ *
+ * @param definition - Typed object definition to compile.
+ * @param categoryIdentifier - Resolved custom-category id or native category id required by the live API.
+ * @returns REST object-update payload.
+ * @typeParam TDefinition - Object definition being compiled.
+ */
+export function buildCustomObjectUpdateParams(definition, categoryIdentifier) {
+    return {
+        category: categoryIdentifier,
+        description: definition.description,
+        ...(definition.enableHistory != null ? { enable_history: definition.enableHistory } : {}),
+        name: definition.displayName,
+        ...(definition.ownerRole != null ? { owner_role: definition.ownerRole } : {}),
+        ...(definition.pluralLabel != null ? { plural_label: definition.pluralLabel } : {}),
+    };
+}
+/**
+ * Builds field create/update payloads for one logical field in a typed object definition.
+ *
+ * @param definition - Typed object definition that owns the field.
+ * @param fieldName - Logical field name to compile.
+ * @returns Frozen create/update payload pair for the field.
+ * @typeParam TDefinition - Object definition being compiled.
+ * @typeParam TFieldName - Logical field name being compiled.
+ */
+export function buildProvisionableFieldParams(definition, fieldName) {
+    const field = definition.fields[fieldName];
+    const dataType = buildFieldDataType(field);
+    const section = buildFieldSection(definition, field);
+    const shared = {
+        description: field.description,
+        data_type: dataType,
+        required: field.required,
+        ...(field.enableHistory != null ? { enable_history: field.enableHistory } : {}),
+        ...(field.formulaAttributeMetas != null ? { formula_attr_metas: field.formulaAttributeMetas } : {}),
+        ...(field.rqlDefinition != null ? { rql_definition: field.rqlDefinition } : {}),
+        ...(section != null ? { section } : {}),
+        ...(isFormulaField(field) ? { derived_field_formula: field.formula } : {}),
+        ...('unique' in field && field.unique != null ? { is_unique: field.unique } : {}),
+    };
+    const create = {
+        name: field.logicalName,
+        ...shared,
+        ...(field.derivedAggregatedField != null ?
+            { derived_aggregated_field: field.derivedAggregatedField }
+            : {}),
+    };
+    // The live GA field update path currently does not accept `derived_aggregated_field`, so keep it create-only.
+    const update = {
+        name: field.displayName,
+        ...shared,
+    };
+    return Object.freeze({ create, update });
+}
+/**
+ * Requires a resolved category identifier for one provisioning operation.
+ *
+ * @param definition - Object definition that needs a category identifier.
+ * @param categoryIdentifier - Resolved custom-category id or native category id, if available.
+ * @returns Required category identifier.
+ * @throws Error when no usable category identifier is available.
+ * @typeParam TDefinition - Object definition being provisioned.
+ */
+function requireCategoryIdentifier(definition, categoryIdentifier) {
+    if (categoryIdentifier != null)
+        return categoryIdentifier;
+    throw new Error(`A category identifier is required to provision "${definition.apiName}". ` +
+        `Provide options.categoryIdentifier or embed/provide a typed category definition.`);
+}
+/**
+ * Rejects duplicate object definitions within one batch provisioning request.
+ *
+ * @param definitions - Typed object definitions to validate for uniqueness.
+ * @throws Error when multiple definitions compile to the same object API name.
+ */
+function assertUniqueObjectDefinitions(definitions) {
+    const seen = new Map();
+    for (const definition of definitions) {
+        const existingName = seen.get(definition.apiName);
+        if (existingName != null) {
+            throw new Error(`Duplicate custom object definition for "${definition.apiName}" in batch: ` +
+                `"${existingName}" and "${definition.name}".`);
+        }
+        seen.set(definition.apiName, definition.name);
+    }
+}
+/**
+ * Collects and deduplicates embedded or explicitly supplied category definitions for a batch provision.
+ *
+ * @param definitions - Object definitions participating in the batch.
+ * @param explicitDefinitions - Optional explicit category definitions supplied by the caller.
+ * @returns Frozen deduplicated category-definition list.
+ * @throws Error when two definitions for the same category API name disagree on visible metadata.
+ */
+function collectCategoryDefinitions(definitions, explicitDefinitions) {
+    const categoryDefinitions = explicitDefinitions ?? definitions.map((definition) => definition.categoryDefinition);
+    const uniqueDefinitions = new Map();
+    for (const definition of categoryDefinitions) {
+        if (definition == null)
+            continue;
+        const existing = uniqueDefinitions.get(definition.apiName);
+        if (existing != null) {
+            if (existing.displayName !== definition.displayName ||
+                existing.description !== definition.description) {
+                throw new Error(`Conflicting category definitions for "${definition.apiName}" in batch provisioning.`);
+            }
+            continue;
+        }
+        uniqueDefinitions.set(definition.apiName, definition);
+    }
+    return Object.freeze([...uniqueDefinitions.values()]);
+}
+/**
+ * Resolves the category identifier that should be sent to the live object APIs during provisioning.
+ *
+ * @param client - SDK client used to provision embedded category definitions when needed.
+ * @param definition - Typed object definition being provisioned.
+ * @param options - Provisioning options that may already contain a category identifier.
+ * @returns Resolved custom-category id or native category id.
+ * @typeParam TDefinition - Object definition being provisioned.
+ */
+async function resolveProvisionedCategoryIdentifier(client, definition, options) {
+    const categoryDefinition = options.categoryDefinition ?? definition.categoryDefinition;
+    if (categoryDefinition == null) {
+        return requireCategoryIdentifier(definition, options.categoryIdentifier);
+    }
+    const provisionedCategory = await provisionCustomObjectCategoryDefinition(client, categoryDefinition);
+    return provisionedCategory.updatedCategory.id;
+}
+/**
+ * Updates the platform-managed `name` field when the typed definition uses autonumber metadata.
+ *
+ * @param client - SDK client used to call the field APIs.
+ * @param definition - Typed object definition whose name-field metadata should be applied.
+ * @param options - Provisioning behavior flags.
+ * @returns Updated `name` field DTO, when a name-field update was required.
+ * @typeParam TDefinition - Object definition being provisioned.
+ */
+async function updateNameFieldDetailsIfNeeded(client, definition, options) {
+    if (!(options.updateNameFieldDetails ?? true))
+        return undefined;
+    const nameFieldDetails = buildCustomObjectNameFieldDetails(definition);
+    if (nameFieldDetails == null)
+        return undefined;
+    return client.customObjects.fields.update(definition.apiName, 'name', {
+        name_field_details: nameFieldDetails,
+    });
+}
+/**
+ * Provisions every custom field for one object definition in relationship-safe order.
+ *
+ * @param client - SDK client used to call the field APIs.
+ * @param definition - Typed object definition whose fields should be provisioned.
+ * @param updateFieldDisplayMetadata - Whether to issue follow-up field updates for display metadata.
+ * @returns Frozen maps of created and updated field DTOs keyed by logical field name.
+ * @typeParam TDefinition - Object definition being provisioned.
+ */
+async function provisionFieldsForDefinition(client, definition, updateFieldDisplayMetadata) {
+    const createdFields = {};
+    const updatedFields = {};
+    const orderedFieldNames = Object.keys(definition.fields).sort((left, right) => {
+        const leftField = definition.fields[left];
+        const rightField = definition.fields[right];
+        return Number(isRelationshipField(leftField)) - Number(isRelationshipField(rightField));
+    });
+    for (const fieldName of orderedFieldNames) {
+        const field = definition.fields[fieldName];
+        const params = buildProvisionableFieldParams(definition, fieldName);
+        const createdField = await client.customObjects.fields.create(definition.apiName, params.create);
+        if (createdField.api_name !== field.apiName) {
+            throw new Error(`Field api_name mismatch for "${definition.name}.${String(fieldName)}": expected "${field.apiName}", got "${createdField.api_name}".`);
+        }
+        createdFields[fieldName] = createdField;
+        updatedFields[fieldName] =
+            updateFieldDisplayMetadata ?
+                await client.customObjects.fields.update(definition.apiName, field.apiName, params.update)
+                : createdField;
+    }
+    return Object.freeze({
+        createdFields: Object.freeze(createdFields),
+        updatedFields: Object.freeze(updatedFields),
+    });
+}
+/**
+ * Creates one typed custom object through the REST SDK and returns the backend responses.
+ *
+ * @param client - SDK client used to call the metadata APIs.
+ * @param definition - Typed object definition to provision.
+ * @param options - Provisioning behavior flags for categories, display metadata, and name fields.
+ * @returns Frozen provisioning result describing the created object, fields, and optional name-field update.
+ * @typeParam TDefinition - Object definition being provisioned.
+ */
+export async function provisionCustomObjectDefinition(client, definition, options = {}) {
+    const updateObjectDisplayMetadata = options.updateObjectDisplayMetadata ?? true;
+    const updateFieldDisplayMetadata = options.updateFieldDisplayMetadata ?? true;
+    const categoryIdentifier = await resolveProvisionedCategoryIdentifier(client, definition, options);
+    const createdObject = await client.customObjects.create(buildCustomObjectCreateParams(definition, categoryIdentifier));
+    if (createdObject.api_name !== definition.apiName) {
+        throw new Error(`Custom object api_name mismatch for "${definition.name}": expected "${definition.apiName}", got "${createdObject.api_name ?? '<missing>'}".`);
+    }
+    const updatedObject = updateObjectDisplayMetadata ?
+        await client.customObjects.update(definition.apiName, buildCustomObjectUpdateParams(definition, categoryIdentifier))
+        : createdObject;
+    const updatedNameField = await updateNameFieldDetailsIfNeeded(client, definition, options);
+    const fieldResults = await provisionFieldsForDefinition(client, definition, updateFieldDisplayMetadata);
+    return Object.freeze({
+        definition,
+        customObjectApiName: definition.apiName,
+        createdObject,
+        updatedObject,
+        ...(updatedNameField != null ? { updatedNameField } : {}),
+        createdFields: fieldResults.createdFields,
+        updatedFields: fieldResults.updatedFields,
+    });
+}
+/**
+ * Provisions multiple typed custom-object definitions through the REST SDK.
+ *
+ * @param client - SDK client used to call the metadata APIs.
+ * @param definitions - Typed object definitions to provision.
+ * @param options - Batch provisioning behavior flags.
+ * @returns Frozen provisioning results in input order.
+ */
+export async function provisionCustomObjectDefinitions(client, definitions, options = {}) {
+    assertUniqueObjectDefinitions(definitions);
+    const categoryDefinitions = collectCategoryDefinitions(definitions, options.categoryDefinitions);
+    const provisionedCategoryIds = new Map();
+    for (const categoryDefinition of categoryDefinitions) {
+        const provisionedCategory = await provisionCustomObjectCategoryDefinition(client, categoryDefinition);
+        provisionedCategoryIds.set(categoryDefinition.apiName, provisionedCategory.updatedCategory.id);
+    }
+    const objectResults = new Map();
+    const updatedNameFields = new Map();
+    for (const definition of definitions) {
+        const categoryIdentifier = definition.categoryDefinition != null ?
+            provisionedCategoryIds.get(definition.categoryDefinition.apiName)
+            : options.categoryIdentifiersByObjectApiName?.[definition.apiName];
+        const resolvedCategoryIdentifier = requireCategoryIdentifier(definition, categoryIdentifier);
+        const createdObject = await client.customObjects.create(buildCustomObjectCreateParams(definition, resolvedCategoryIdentifier));
+        if (createdObject.api_name !== definition.apiName) {
+            throw new Error(`Custom object api_name mismatch for "${definition.name}": expected "${definition.apiName}", got "${createdObject.api_name ?? '<missing>'}".`);
+        }
+        const updatedObject = options.updateObjectDisplayMetadata ?? true ?
+            await client.customObjects.update(definition.apiName, buildCustomObjectUpdateParams(definition, resolvedCategoryIdentifier))
+            : createdObject;
+        objectResults.set(definition.apiName, Object.freeze({ created: createdObject, updated: updatedObject }));
+        const updatedNameField = await updateNameFieldDetailsIfNeeded(client, definition, options);
+        if (updatedNameField != null)
+            updatedNameFields.set(definition.apiName, updatedNameField);
+    }
+    const results = [];
+    for (const definition of definitions) {
+        const objectResult = objectResults.get(definition.apiName);
+        if (objectResult == null) {
+            throw new Error(`Missing created object response for "${definition.apiName}".`);
+        }
+        const fieldResults = await provisionFieldsForDefinition(client, definition, options.updateFieldDisplayMetadata ?? true);
+        const updatedNameField = updatedNameFields.get(definition.apiName);
+        results.push(Object.freeze({
+            definition,
+            customObjectApiName: definition.apiName,
+            createdObject: objectResult.created,
+            updatedObject: objectResult.updated,
+            ...(updatedNameField != null ? { updatedNameField } : {}),
+            createdFields: fieldResults.createdFields,
+            updatedFields: fieldResults.updatedFields,
+        }));
+    }
+    return Object.freeze(results);
+}
+//# sourceMappingURL=provisioning.mjs.map

package/core/platform/custom-objects/provisioning.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"provisioning.mjs","sourceRoot":"","sources":["../../../src/core/platform/custom-objects/provisioning.ts"],"names":[],"mappings":"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"}

package/core/platform/custom-objects/rql.d.mts

@@ -0,0 +1,122 @@
+import type { AnyCustomObjectDefinition, FieldNames, FieldValue, LookupReference } from "./types.mjs";
+declare const STANDARD_RQL_FIELD_NAMES: readonly ["id", "name", "created_at", "updated_at", "system_updated_at", "external_id", "owner_role", "created_by", "last_modified_by"];
+type StandardRqlFieldValueByName = {
+    id: string;
+    name: string;
+    created_at: string | null;
+    updated_at: string | null;
+    system_updated_at: string | null;
+    external_id: string | null;
+    owner_role: LookupReference<'Employee'> | null;
+    created_by: LookupReference<'Employee'> | null;
+    last_modified_by: LookupReference<'Employee'> | null;
+};
+/**
+ * Standard field-name strings exposed by the typed RQL helper.
+ *
+ * @typeParam TDefinition - Object definition whose standard fields should be exposed.
+ */
+export type StandardRqlFieldName<TDefinition extends AnyCustomObjectDefinition> = (typeof STANDARD_RQL_FIELD_NAMES)[number];
+/**
+ * Field-name strings accepted by the typed RQL helper.
+ *
+ * @typeParam TDefinition - Object definition whose field-name union should be exposed.
+ */
+export type RqlFieldName<TDefinition extends AnyCustomObjectDefinition> = StandardRqlFieldName<TDefinition> | FieldNames<TDefinition>;
+/**
+ * Field token used by the RQL helper to preserve type information across string compilation.
+ *
+ * @typeParam TValue - Runtime value type stored in the field.
+ * @typeParam TApiName - Wire-level field api name used when rendering RQL.
+ */
+export interface RqlFieldToken<TValue = unknown, TApiName extends string = string> {
+    readonly kind: 'rql-field-token';
+    readonly apiName: TApiName;
+    readonly logicalName: string;
+    readonly __valueType__?: TValue;
+}
+/**
+ * Opaque RQL fragment that can be interpolated into {@link CustomObjectRqlHelpers.rql}.
+ */
+export interface RqlFragment {
+    readonly kind: 'rql-fragment';
+    readonly text: string;
+}
+/**
+ * Scope object whose properties autocomplete to the standard and custom fields available on one object definition.
+ *
+ * @typeParam TDefinition - Object definition whose field tokens should be exposed.
+ */
+export type RqlFieldScope<TDefinition extends AnyCustomObjectDefinition> = {
+    readonly [K in StandardRqlFieldName<TDefinition>]: RqlFieldToken<StandardRqlFieldValueByName[K], K>;
+} & {
+    readonly [K in FieldNames<TDefinition>]: RqlFieldToken<FieldValue<TDefinition['fields'][K]>, TDefinition['fields'][K] extends {
+        apiName: infer TApiName extends string;
+    } ? TApiName : string>;
+};
+/**
+ * Input that the RQL helper knows how to encode as a literal value.
+ */
+export type RqlValue = string | number | boolean | null | LookupReference<string> | readonly RqlValue[];
+/**
+ * Runtime surface returned by {@link createRqlHelpers}.
+ *
+ * @typeParam TDefinition - Object definition whose field tokens should be exposed.
+ */
+export interface CustomObjectRqlHelpers<TDefinition extends AnyCustomObjectDefinition> {
+    /** Object-scoped field tokens used for IntelliSense-friendly property access. */
+    readonly fields: RqlFieldScope<TDefinition>;
+    /** Converts a field-name string into a typed field token. */
+    field<TFieldName extends RqlFieldName<TDefinition>>(fieldName: TFieldName): RqlFieldScope<TDefinition>[TFieldName];
+    /** Renders a tagged template into a backend-ready RQL string. */
+    rql(strings: TemplateStringsArray, ...values: readonly RqlInterpolation[]): string;
+    /** Renders a fragment built by helper functions into a string. */
+    render(fragment: RqlFragment): string;
+    /** Wraps a raw RQL snippet as a fragment. Use sparingly. */
+    raw(text: string): RqlFragment;
+    /** Builds an equality comparison fragment. */
+    eq<TValue>(field: RqlFieldToken<TValue>, value: RqlComparableValue<TValue> | null): RqlFragment;
+    /** Builds an inequality comparison fragment. */
+    ne<TValue>(field: RqlFieldToken<TValue>, value: RqlComparableValue<TValue> | null): RqlFragment;
+    /** Builds a less-than comparison fragment. */
+    lt<TValue extends string | number>(field: RqlFieldToken<TValue>, value: TValue): RqlFragment;
+    /** Builds a less-than-or-equal comparison fragment. */
+    lte<TValue extends string | number>(field: RqlFieldToken<TValue>, value: TValue): RqlFragment;
+    /** Builds a greater-than comparison fragment. */
+    gt<TValue extends string | number>(field: RqlFieldToken<TValue>, value: TValue): RqlFragment;
+    /** Builds a greater-than-or-equal comparison fragment. */
+    gte<TValue extends string | number>(field: RqlFieldToken<TValue>, value: TValue): RqlFragment;
+    /** Builds an `IN` comparison fragment. */
+    in<TValue>(field: RqlFieldToken<TValue>, values: readonly RqlComparableValue<TValue>[]): RqlFragment;
+    /** Builds a `NOT_IN` comparison fragment. */
+    notIn<TValue>(field: RqlFieldToken<TValue>, values: readonly RqlComparableValue<TValue>[]): RqlFragment;
+    /** Builds an `IS NULL`-style equality fragment. */
+    isNull<TValue>(field: RqlFieldToken<TValue>): RqlFragment;
+    /** Builds an `IS NOT NULL`-style inequality fragment. */
+    isNotNull<TValue>(field: RqlFieldToken<TValue>): RqlFragment;
+    /** Builds a parenthesized `AND` fragment. */
+    and(...fragments: readonly RqlFragment[]): RqlFragment;
+    /** Builds a parenthesized `OR` fragment. */
+    or(...fragments: readonly RqlFragment[]): RqlFragment;
+    /** Builds a parenthesized `NOT` fragment. */
+    not(fragment: RqlFragment): RqlFragment;
+}
+/** Allowed comparison inputs for one field token. */
+export type RqlComparableValue<TValue> = TValue extends LookupReference<string> ? TValue | string : TValue;
+/** Interpolation values accepted by the tagged-template compiler. */
+export type RqlInterpolation = RqlFieldToken | RqlFragment | RqlValue;
+/**
+ * Creates a typed RQL helper surface for one custom-object definition.
+ *
+ * The helper keeps authoring close to raw RQL by combining a tagged-template
+ * compiler with IntelliSense-friendly field tokens. Callers write normal RQL in
+ * string segments and interpolate typed field references or JavaScript literal
+ * values where they want compiler assistance.
+ *
+ * @param definition - Typed object definition whose field tokens should be exposed.
+ * @returns Typed RQL helper surface bound to the supplied object definition.
+ * @typeParam TDefinition - Object definition whose field tokens should be exposed.
+ */
+export declare function createRqlHelpers<TDefinition extends AnyCustomObjectDefinition>(definition: TDefinition): CustomObjectRqlHelpers<TDefinition>;
+export {};
+//# sourceMappingURL=rql.d.mts.map

package/core/platform/custom-objects/rql.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rql.d.mts","sourceRoot":"","sources":["../../../src/core/platform/custom-objects/rql.ts"],"names":[],"mappings":"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"}