@rulebricks/sdk 1.5.2 → 2.0.0

package/dist/api/resources/contexts/client/Client.d.ts

@@ -0,0 +1,167 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.js";
+import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.js";
+import * as core from "../../../../core/index.js";
+import * as Rulebricks from "../../../index.js";
+import { AdminClient } from "../resources/admin/client/Client.js";
+import { RelationshipsClient } from "../resources/relationships/client/Client.js";
+export declare namespace ContextsClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+/**
+ * Operations for managing and interacting with Contexts (Entities) and their instances
+ */
+export declare class ContextsClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<ContextsClient.Options>;
+    protected _admin: AdminClient | undefined;
+    protected _relationships: RelationshipsClient | undefined;
+    constructor(options: ContextsClient.Options);
+    get admin(): AdminClient;
+    get relationships(): RelationshipsClient;
+    /**
+     * Retrieve the current state of a context instance.
+     *
+     * @param {Rulebricks.GetInstanceContextsRequest} request
+     * @param {ContextsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Rulebricks.NotFoundError}
+     * @throws {@link Rulebricks.InternalServerError}
+     *
+     * @example
+     *     await client.contexts.getInstance({
+     *         slug: "customer",
+     *         instance: "cust-12345"
+     *     })
+     */
+    getInstance(request: Rulebricks.GetInstanceContextsRequest, requestOptions?: ContextsClient.RequestOptions): core.HttpResponsePromise<Rulebricks.ContextInstanceState>;
+    private __getInstance;
+    /**
+     * Submit data to a context instance, creating it if it doesn't exist. May trigger bound rule/flow evaluations.
+     *
+     * @param {Rulebricks.SubmitContextsRequest} request
+     * @param {ContextsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Rulebricks.BadRequestError}
+     * @throws {@link Rulebricks.NotFoundError}
+     * @throws {@link Rulebricks.InternalServerError}
+     *
+     * @example
+     *     await client.contexts.submit({
+     *         slug: "customer",
+     *         instance: "cust-12345",
+     *         body: {
+     *             "email": "customer@example.com",
+     *             "age": 30
+     *         }
+     *     })
+     */
+    submit(request: Rulebricks.SubmitContextsRequest, requestOptions?: ContextsClient.RequestOptions): core.HttpResponsePromise<Rulebricks.SubmitContextDataResponse>;
+    private __submit;
+    /**
+     * Delete a specific context instance and its history.
+     *
+     * @param {Rulebricks.DeleteInstanceContextsRequest} request
+     * @param {ContextsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Rulebricks.NotFoundError}
+     * @throws {@link Rulebricks.InternalServerError}
+     *
+     * @example
+     *     await client.contexts.deleteInstance({
+     *         slug: "customer",
+     *         instance: "cust-12345"
+     *     })
+     */
+    deleteInstance(request: Rulebricks.DeleteInstanceContextsRequest, requestOptions?: ContextsClient.RequestOptions): core.HttpResponsePromise<Rulebricks.DeleteContextInstanceResponse>;
+    private __deleteInstance;
+    /**
+     * Retrieve the change history for a context instance.
+     *
+     * @param {Rulebricks.GetHistoryContextsRequest} request
+     * @param {ContextsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Rulebricks.NotFoundError}
+     * @throws {@link Rulebricks.InternalServerError}
+     *
+     * @example
+     *     await client.contexts.getHistory({
+     *         slug: "customer",
+     *         instance: "cust-12345"
+     *     })
+     */
+    getHistory(request: Rulebricks.GetHistoryContextsRequest, requestOptions?: ContextsClient.RequestOptions): core.HttpResponsePromise<Rulebricks.ContextInstanceHistory>;
+    private __getHistory;
+    /**
+     * Get list of rules/flows that need to be evaluated for this instance.
+     *
+     * @param {Rulebricks.GetPendingContextsRequest} request
+     * @param {ContextsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Rulebricks.NotFoundError}
+     * @throws {@link Rulebricks.InternalServerError}
+     *
+     * @example
+     *     await client.contexts.getPending({
+     *         slug: "customer",
+     *         instance: "cust-12345"
+     *     })
+     */
+    getPending(request: Rulebricks.GetPendingContextsRequest, requestOptions?: ContextsClient.RequestOptions): core.HttpResponsePromise<Rulebricks.ContextInstancePendingResponse>;
+    private __getPending;
+    /**
+     * Execute a specific rule using the context instance's state as input.
+     *
+     * @param {Rulebricks.SolveContextRuleRequest} request
+     * @param {ContextsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Rulebricks.BadRequestError}
+     * @throws {@link Rulebricks.NotFoundError}
+     * @throws {@link Rulebricks.InternalServerError}
+     *
+     * @example
+     *     await client.contexts.solve({
+     *         slug: "customer",
+     *         instance: "cust-12345",
+     *         ruleSlug: "eligibility-check"
+     *     })
+     */
+    solve(request: Rulebricks.SolveContextRuleRequest, requestOptions?: ContextsClient.RequestOptions): core.HttpResponsePromise<Rulebricks.SolveContextRuleResponse>;
+    private __solve;
+    /**
+     * Trigger re-evaluation of all bound rules and flows for the instance.
+     *
+     * @param {Rulebricks.CascadeContextRequest} request
+     * @param {ContextsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Rulebricks.NotFoundError}
+     * @throws {@link Rulebricks.InternalServerError}
+     *
+     * @example
+     *     await client.contexts.cascade({
+     *         slug: "customer",
+     *         instance: "cust-12345"
+     *     })
+     */
+    cascade(request: Rulebricks.CascadeContextRequest, requestOptions?: ContextsClient.RequestOptions): core.HttpResponsePromise<Rulebricks.CascadeContextResponse>;
+    private __cascade;
+    /**
+     * Execute a specific flow using the context instance's state as input.
+     *
+     * @param {Rulebricks.SolveContextFlowRequest} request
+     * @param {ContextsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Rulebricks.BadRequestError}
+     * @throws {@link Rulebricks.NotFoundError}
+     * @throws {@link Rulebricks.InternalServerError}
+     *
+     * @example
+     *     await client.contexts.execute({
+     *         slug: "customer",
+     *         instance: "cust-12345",
+     *         flowSlug: "onboarding-flow"
+     *     })
+     */
+    execute(request: Rulebricks.SolveContextFlowRequest, requestOptions?: ContextsClient.RequestOptions): core.HttpResponsePromise<Rulebricks.SolveContextFlowResponse>;
+    private __execute;
+}