@bedrock-rbx/ocale 0.1.0-beta.1 → 0.1.0-beta.3

package/dist/luau-execution.d.mts

@@ -0,0 +1,149 @@
+import { d as OpenCloudError, i as OpenCloudClientOptions, l as Result, s as RequestOptions } from "./types-DUzm6maA.mjs";
+import { a as CompleteTask, c as InProgressTask, d as SubmitAtHeadParameters, f as SubmitAtVersionParameters, i as LogPage, l as LuauExecutionTask, n as ListLogsParameters, o as FailedTask, r as LogMessage, s as GetParameters, t as PollUntilDoneOptions, u as LuauExecutionTaskRef } from "./polling-Cc50rgl6.mjs";
+
+//#region src/domains/cloud-v2/luau-execution-task-binary-inputs/types.d.ts
+/**
+* Caller-supplied input for creating a Luau execution task binary input
+* upload slot. The server returns a presigned `uploadUri` the caller uses
+* to PUT the binary data.
+*/
+interface CreateBinaryInputParameters {
+  /** Size in bytes of the binary data to be uploaded. */
+  readonly size: number;
+  /** Stringified ID of the universe that owns the task. */
+  readonly universeId: string;
+}
+/**
+* Public representation of a created Luau execution task binary input.
+* Pass `path` verbatim to `tasks.submit({ binaryInput })`.
+*/
+interface LuauExecutionTaskBinaryInput {
+  /** Server-emitted resource path; pass to `tasks.submit` as `binaryInput`. */
+  readonly path: string;
+  /** Presigned PUT target; perform the binary upload to this URI directly. */
+  readonly uploadUri: string;
+}
+//#endregion
+//#region src/resources/luau-execution/client.d.ts
+/**
+* Operation handle for the `binaryInputs` namespace on
+* {@link LuauExecutionClient}. Provides `create` to allocate a presigned
+* upload slot for binary script inputs.
+*/
+interface BinaryInputsHandle {
+  /**
+  * Allocates a presigned binary input upload slot. The returned
+  * `uploadUri` is a presigned `PUT` target; the caller uploads the
+  * binary data directly and passes `path` to `tasks.submit` as
+  * `binaryInput`.
+  *
+  * @param parameters - Universe identifier and the byte size of the
+  *   binary to upload.
+  * @param options - Optional per-request overrides.
+  * @returns A {@link Result} wrapping the parsed
+  *   {@link LuauExecutionTaskBinaryInput} or the {@link OpenCloudError}
+  *   that caused the request to fail.
+  */
+  create(parameters: CreateBinaryInputParameters, options?: RequestOptions): Promise<Result<LuauExecutionTaskBinaryInput, OpenCloudError>>;
+}
+/**
+* Operation handle exposed by {@link LuauExecutionClient} as the
+* `tasks` namespace. Provides `submit` to queue a Luau script, `get`
+* to fetch a task's current state, and `listLogs` to retrieve
+* structured log messages produced by a task.
+*/
+interface TasksHandle {
+  /**
+  * Fetches the current state of a previously-submitted Luau
+  * execution task. Uses idempotent retry semantics for both 429 and
+  * 5xx.
+  *
+  * @param parameters - The task ref plus an optional `view` selector.
+  * @param options - Optional per-request overrides (e.g. A different
+  *   {@link OpenCloudClientOptions.apiKey} for this call only).
+  * @returns A {@link Result} wrapping the parsed
+  *   {@link LuauExecutionTask} or the {@link OpenCloudError} that
+  *   caused the request to fail.
+  */
+  get(parameters: GetParameters, options?: RequestOptions): Promise<Result<LuauExecutionTask, OpenCloudError>>;
+  /**
+  * Lists one page of structured log messages produced by a
+  * previously-submitted Luau execution task. Messages from multiple
+  * server-side chunks are flattened into a single ordered array.
+  * Uses idempotent retry semantics for both 429 and 5xx.
+  *
+  * @param parameters - The task ref and optional pagination controls
+  *   (`pageSize`, `pageToken`).
+  * @param options - Optional per-request overrides (e.g. A different
+  *   {@link OpenCloudClientOptions.apiKey} for this call only).
+  * @returns A {@link Result} wrapping the parsed {@link LogPage} or
+  *   the {@link OpenCloudError} that caused the request to fail.
+  */
+  listLogs(parameters: ListLogsParameters, options?: RequestOptions): Promise<Result<LogPage, OpenCloudError>>;
+  /**
+  * Polls `tasks.get` with `view=BASIC` on a configurable backoff schedule
+  * until the task reaches a terminal state, the wall-clock budget is
+  * exhausted, or the supplied `AbortSignal` fires. Returns the terminal
+  * task on success.
+  *
+  * @param ref - Reference to the task to poll, typically returned by `submit`.
+  * @param options - Polling and per-request overrides.
+  * @returns A {@link Result} wrapping the terminal {@link LuauExecutionTask},
+  *   or an error if aborted, timed out, or the transport fails.
+  */
+  pollUntilDone(ref: LuauExecutionTaskRef, options?: PollUntilDoneOptions): Promise<Result<LuauExecutionTask, OpenCloudError>>;
+  /**
+  * Submits a Luau script and polls `tasks.get` with `view=BASIC` until
+  * the task reaches a terminal state, the wall-clock budget is
+  * exhausted, or the supplied `AbortSignal` fires. Combines `submit`
+  * and `pollUntilDone` in one call.
+  *
+  * @param parameters - The same input accepted by `submit`.
+  * @param options - Polling and per-request overrides.
+  * @returns A {@link Result} wrapping the terminal
+  *   {@link LuauExecutionTask}, or an error if submit fails, the task
+  *   is aborted, timed out, or the transport fails.
+  */
+  runUntilDone(parameters: SubmitAtHeadParameters | SubmitAtVersionParameters, options?: PollUntilDoneOptions): Promise<Result<LuauExecutionTask, OpenCloudError>>;
+  /**
+  * Submits a Luau script for execution against a place. Dispatches
+  * to the head-version URL when `versionId` is omitted, or to the
+  * specific-version URL when one is supplied. Both URL shapes share
+  * one rate-limit queue and one required-scope set.
+  *
+  * @param parameters - The universe and place identifiers, the
+  *   script to run, an optional `versionId`, and any other writable
+  *   submit fields.
+  * @param options - Optional per-request overrides (e.g. A different
+  *   {@link OpenCloudClientOptions.apiKey} for this call only).
+  * @returns A {@link Result} wrapping the parsed
+  *   {@link LuauExecutionTask} or the {@link OpenCloudError} that
+  *   caused the request to fail.
+  */
+  submit(parameters: SubmitAtHeadParameters | SubmitAtVersionParameters, options?: RequestOptions): Promise<Result<LuauExecutionTask, OpenCloudError>>;
+}
+/**
+* Public client for the Roblox Open Cloud `LuauExecutionSessionTask`
+* resource. Tasks run a Luau script against a place and surface state,
+* output, or error through the `LuauExecutionTask` discriminated
+* union. Exposes `tasks.submit` for both the head version and a
+* specific place version, `tasks.get` for fetching task state,
+* `tasks.listLogs` for fetching structured log messages, and
+* `binaryInputs.create` for allocating presigned upload slots.
+*/
+declare class LuauExecutionClient {
+  #private;
+  readonly binaryInputs: BinaryInputsHandle;
+  readonly tasks: TasksHandle;
+  /**
+  * Creates a new {@link LuauExecutionClient}. Configuration is frozen
+  * on construction; per-request overrides are accepted on each
+  * method.
+  *
+  * @param options - Client-level configuration including the API key.
+  */
+  constructor(options: OpenCloudClientOptions);
+}
+//#endregion
+export { type BinaryInputsHandle, type CompleteTask, type CreateBinaryInputParameters, type FailedTask, type GetParameters, type InProgressTask, type ListLogsParameters, type LogMessage, type LogPage, LuauExecutionClient, type LuauExecutionTask, type LuauExecutionTaskBinaryInput, type LuauExecutionTaskRef, type PollUntilDoneOptions, type SubmitAtHeadParameters, type SubmitAtVersionParameters, type TasksHandle };
+//# sourceMappingURL=luau-execution.d.mts.map

package/dist/luau-execution.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"luau-execution.d.mts","names":[],"sources":["../src/domains/cloud-v2/luau-execution-task-binary-inputs/types.ts","../src/resources/luau-execution/client.ts"],"mappings":";;;;;;;;AAKA;UAAiB,2BAAA;;WAEP,IAAA;EAEA;EAAA,SAAA,UAAA;AAAA;;;;;UAOO,4BAAA;;WAEP,IAAA;EC0CO;EAAA,SDxCP,SAAA;AAAA;;;;;AAJV;;;UC4CiB,kBAAA;EDxCP;;;;ACwCV;;;;;;;;;EAcC,MAAA,CACC,UAAA,EAAY,2BAAA,EACZ,OAAA,GAAU,cAAA,GACR,OAAA,CAAQ,MAAA,CAAO,4BAAA,EAA8B,cAAA;AAAA;;;;;;;UAShC,WAAA;;;;;AAAjB;;;;;;;;EAaC,GAAA,CACC,UAAA,EAAY,aAAA,EACZ,OAAA,GAAU,cAAA,GACR,OAAA,CAAQ,MAAA,CAAO,iBAAA,EAAmB,cAAA;;;;;;;;;;;;;;EAcrC,QAAA,CACC,UAAA,EAAY,kBAAA,EACZ,OAAA,GAAU,cAAA,GACR,OAAA,CAAQ,MAAA,CAAO,OAAA,EAAS,cAAA;;;;;;;;;;;;EAY3B,aAAA,CACC,GAAA,EAAK,oBAAA,EACL,OAAA,GAAU,oBAAA,GACR,OAAA,CAAQ,MAAA,CAAO,iBAAA,EAAmB,cAAA;;;;;;;;;;;;;EAarC,YAAA,CACC,UAAA,EAAY,sBAAA,GAAyB,yBAAA,EACrC,OAAA,GAAU,oBAAA,GACR,OAAA,CAAQ,MAAA,CAAO,iBAAA,EAAmB,cAAA;;;;;;;;;;;;;;;;EAgBrC,MAAA,CACC,UAAA,EAAY,sBAAA,GAAyB,yBAAA,EACrC,OAAA,GAAU,cAAA,GACR,OAAA,CAAQ,MAAA,CAAO,iBAAA,EAAmB,cAAA;AAAA;;;;;;;;;;cAYzB,mBAAA;EAAA;WAGI,YAAA,EAAc,kBAAA;EAAA,SACd,KAAA,EAAO,WAAA;;;;;;;;EASvB,WAAA,CAAY,OAAA,EAAS,sBAAA;AAAA"}

package/dist/luau-execution.mjs

@@ -0,0 +1,164 @@
+import { i as ApiError } from "./rate-limit-CKfuhxT1.mjs";
+import { i as CREATE_METHOD_DEFAULTS, n as okRequest, s as isRecord, t as ResourceClient } from "./resource-client-opC6BUkL.mjs";
+import { a as SUBMIT_HEAD_SPEC, i as GET_SPEC, n as submitAndPoll, o as SUBMIT_VERSION_SPEC, r as pollUntilDoneCore, s as LIST_LOGS_SPEC, t as buildPollDeps } from "./polling-helpers-BVkmr6C7.mjs";
+//#region src/domains/cloud-v2/luau-execution-task-binary-inputs/builders.ts
+/**
+* Builds a `POST` request for the Open Cloud
+* `Cloud_CreateLuauExecutionSessionTaskBinaryInput` endpoint. The
+* server responds with a presigned `uploadUri` and the resource `path`.
+*
+* @param parameters - Universe identifier and the byte size of the
+*   binary to be uploaded.
+* @returns A pure {@link HttpRequest} describing the create call.
+*/
+function buildCreateBinaryInputRequest(parameters) {
+	const { size, universeId } = parameters;
+	return {
+		body: { size },
+		headers: { "content-type": "application/json" },
+		method: "POST",
+		url: `/cloud/v2/universes/${universeId}/luau-execution-session-task-binary-inputs`
+	};
+}
+/**
+* Per-second request ceiling for creating a Luau execution task binary
+* input, sourced from `x-roblox-rate-limits.perApiKeyOwner` on the
+* `Cloud_CreateLuauExecutionSessionTaskBinaryInput` operation (5 requests
+* per minute per API key owner).
+*/
+const CREATE_OPERATION_LIMIT = Object.freeze({
+	maxPerSecond: 5 / 60,
+	operationKey: "luau-execution-task-binary-inputs.create"
+});
+/**
+* Scopes required to create a Luau execution task binary input, sourced
+* from `x-roblox-scopes` on the create operation in the vendored OpenAPI
+* schema.
+*/
+const CREATE_REQUIRED_SCOPES = Object.freeze(["universe.place.luau-execution-session:write"]);
+//#endregion
+//#region src/domains/cloud-v2/luau-execution-task-binary-inputs/parsers.ts
+const PATH_PATTERN = /^universes\/(\d+)\/luau-execution-session-task-binary-inputs\/([^/]+)$/;
+const MALFORMED_MESSAGE = "Malformed luau-execution-session-task-binary-input response";
+/**
+* Parses a successful Open Cloud
+* `Cloud_CreateLuauExecutionSessionTaskBinaryInput` response body into
+* the public {@link LuauExecutionTaskBinaryInput}.
+*
+* @param response - The full {@link HttpResponse} from the Open Cloud API.
+* @returns A success result wrapping the parsed binary input, or an
+*   {@link ApiError} when the body does not match the expected shape.
+*/
+function parseBinaryInputResponse(response) {
+	const { body, status: statusCode } = response;
+	if (!isRecord(body)) return malformed(statusCode);
+	if (typeof body["path"] !== "string" || !PATH_PATTERN.test(body["path"])) return malformed(statusCode);
+	if (typeof body["uploadUri"] !== "string") return malformed(statusCode);
+	return {
+		data: {
+			path: body["path"],
+			uploadUri: body["uploadUri"]
+		},
+		success: true
+	};
+}
+function malformed(statusCode) {
+	return {
+		err: new ApiError(MALFORMED_MESSAGE, { statusCode }),
+		success: false
+	};
+}
+//#endregion
+//#region src/resources/luau-execution/client.ts
+function makeSpec(spec) {
+	return Object.freeze(spec);
+}
+const CREATE_BINARY_INPUT_SPEC = makeSpec({
+	buildRequest: (parameters) => okRequest(buildCreateBinaryInputRequest(parameters)),
+	methodDefaults: CREATE_METHOD_DEFAULTS,
+	methodKind: "create",
+	operationLimit: CREATE_OPERATION_LIMIT,
+	parse: parseBinaryInputResponse,
+	requiredScopes: CREATE_REQUIRED_SCOPES
+});
+/**
+* Public client for the Roblox Open Cloud `LuauExecutionSessionTask`
+* resource. Tasks run a Luau script against a place and surface state,
+* output, or error through the `LuauExecutionTask` discriminated
+* union. Exposes `tasks.submit` for both the head version and a
+* specific place version, `tasks.get` for fetching task state,
+* `tasks.listLogs` for fetching structured log messages, and
+* `binaryInputs.create` for allocating presigned upload slots.
+*/
+var LuauExecutionClient = class {
+	#inner;
+	binaryInputs;
+	tasks;
+	/**
+	* Creates a new {@link LuauExecutionClient}. Configuration is frozen
+	* on construction; per-request overrides are accepted on each
+	* method.
+	*
+	* @param options - Client-level configuration including the API key.
+	*/
+	constructor(options) {
+		this.#inner = new ResourceClient(options);
+		this.binaryInputs = createBinaryInputsHandle(this.#inner);
+		this.tasks = createTasksHandle(this.#inner);
+	}
+};
+function createBinaryInputsHandle(inner) {
+	return { async create(parameters, options) {
+		return inner.execute({
+			options,
+			parameters,
+			spec: CREATE_BINARY_INPUT_SPEC
+		});
+	} };
+}
+function createTasksHandle(inner) {
+	return {
+		async get(parameters, options) {
+			return inner.execute({
+				options,
+				parameters,
+				spec: GET_SPEC
+			});
+		},
+		async listLogs(parameters, options) {
+			return inner.execute({
+				options,
+				parameters,
+				spec: LIST_LOGS_SPEC
+			});
+		},
+		async pollUntilDone(ref, options = {}) {
+			return pollUntilDoneCore(buildPollDeps(inner, {
+				options,
+				ref
+			}), options);
+		},
+		async runUntilDone(parameters, options = {}) {
+			return submitAndPoll(inner, {
+				options,
+				parameters
+			});
+		},
+		async submit(parameters, options) {
+			if ("versionId" in parameters) return inner.execute({
+				options,
+				parameters,
+				spec: SUBMIT_VERSION_SPEC
+			});
+			return inner.execute({
+				options,
+				parameters,
+				spec: SUBMIT_HEAD_SPEC
+			});
+		}
+	};
+}
+//#endregion
+export { LuauExecutionClient };
+
+//# sourceMappingURL=luau-execution.mjs.map

package/dist/luau-execution.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"luau-execution.mjs","names":["#inner"],"sources":["../src/domains/cloud-v2/luau-execution-task-binary-inputs/builders.ts","../src/domains/cloud-v2/luau-execution-task-binary-inputs/operations.ts","../src/domains/cloud-v2/luau-execution-task-binary-inputs/parsers.ts","../src/resources/luau-execution/client.ts"],"sourcesContent":["import type { HttpRequest } from \"../../../client/types.ts\";\nimport type { CreateBinaryInputParameters } from \"./types.ts\";\n\n/**\n * Builds a `POST` request for the Open Cloud\n * `Cloud_CreateLuauExecutionSessionTaskBinaryInput` endpoint. The\n * server responds with a presigned `uploadUri` and the resource `path`.\n *\n * @param parameters - Universe identifier and the byte size of the\n *   binary to be uploaded.\n * @returns A pure {@link HttpRequest} describing the create call.\n */\nexport function buildCreateBinaryInputRequest(\n\tparameters: CreateBinaryInputParameters,\n): HttpRequest {\n\tconst { size, universeId } = parameters;\n\treturn {\n\t\tbody: { size },\n\t\theaders: { \"content-type\": \"application/json\" },\n\t\tmethod: \"POST\",\n\t\turl: `/cloud/v2/universes/${universeId}/luau-execution-session-task-binary-inputs`,\n\t};\n}\n","import type { OperationLimit } from \"../../../internal/http/rate-limit-queue.ts\";\n\nconst CREATE_PER_MINUTE = 5;\nconst SECONDS_PER_MINUTE = 60;\n\n/**\n * Per-second request ceiling for creating a Luau execution task binary\n * input, sourced from `x-roblox-rate-limits.perApiKeyOwner` on the\n * `Cloud_CreateLuauExecutionSessionTaskBinaryInput` operation (5 requests\n * per minute per API key owner).\n */\nexport const CREATE_OPERATION_LIMIT: OperationLimit = Object.freeze({\n\tmaxPerSecond: CREATE_PER_MINUTE / SECONDS_PER_MINUTE,\n\toperationKey: \"luau-execution-task-binary-inputs.create\",\n});\n\n/**\n * Scopes required to create a Luau execution task binary input, sourced\n * from `x-roblox-scopes` on the create operation in the vendored OpenAPI\n * schema.\n */\nexport const CREATE_REQUIRED_SCOPES: ReadonlyArray<string> = Object.freeze([\n\t\"universe.place.luau-execution-session:write\",\n]);\n","import type { HttpResponse } from \"../../../client/types.ts\";\nimport { ApiError } from \"../../../errors/api-error.ts\";\nimport { isRecord } from \"../../../internal/utils/is-record.ts\";\nimport type { Result } from \"../../../types.ts\";\nimport type { LuauExecutionTaskBinaryInput } from \"./types.ts\";\n\nconst PATH_PATTERN = /^universes\\/(\\d+)\\/luau-execution-session-task-binary-inputs\\/([^/]+)$/;\n\nconst MALFORMED_MESSAGE = \"Malformed luau-execution-session-task-binary-input response\";\n\n/**\n * Parses a successful Open Cloud\n * `Cloud_CreateLuauExecutionSessionTaskBinaryInput` response body into\n * the public {@link LuauExecutionTaskBinaryInput}.\n *\n * @param response - The full {@link HttpResponse} from the Open Cloud API.\n * @returns A success result wrapping the parsed binary input, or an\n *   {@link ApiError} when the body does not match the expected shape.\n */\nexport function parseBinaryInputResponse(\n\tresponse: HttpResponse,\n): Result<LuauExecutionTaskBinaryInput, ApiError> {\n\tconst { body, status: statusCode } = response;\n\n\tif (!isRecord(body)) {\n\t\treturn malformed(statusCode);\n\t}\n\n\tif (typeof body[\"path\"] !== \"string\" || !PATH_PATTERN.test(body[\"path\"])) {\n\t\treturn malformed(statusCode);\n\t}\n\n\tif (typeof body[\"uploadUri\"] !== \"string\") {\n\t\treturn malformed(statusCode);\n\t}\n\n\treturn {\n\t\tdata: { path: body[\"path\"], uploadUri: body[\"uploadUri\"] },\n\t\tsuccess: true,\n\t};\n}\n\nfunction malformed(statusCode: number): Result<LuauExecutionTaskBinaryInput, ApiError> {\n\treturn { err: new ApiError(MALFORMED_MESSAGE, { statusCode }), success: false };\n}\n","import type { OpenCloudClientOptions, RequestOptions } from \"../../client/types.ts\";\nimport { buildCreateBinaryInputRequest } from \"../../domains/cloud-v2/luau-execution-task-binary-inputs/builders.ts\";\nimport {\n\tCREATE_OPERATION_LIMIT,\n\tCREATE_REQUIRED_SCOPES,\n} from \"../../domains/cloud-v2/luau-execution-task-binary-inputs/operations.ts\";\nimport { parseBinaryInputResponse } from \"../../domains/cloud-v2/luau-execution-task-binary-inputs/parsers.ts\";\nimport type {\n\tCreateBinaryInputParameters,\n\tLuauExecutionTaskBinaryInput,\n} from \"../../domains/cloud-v2/luau-execution-task-binary-inputs/types.ts\";\nimport { LIST_LOGS_SPEC } from \"../../domains/cloud-v2/luau-execution-task-logs/specs.ts\";\nimport type {\n\tListLogsParameters,\n\tLogPage,\n} from \"../../domains/cloud-v2/luau-execution-task-logs/types.ts\";\nimport {\n\tGET_SPEC,\n\tSUBMIT_HEAD_SPEC,\n\tSUBMIT_VERSION_SPEC,\n} from \"../../domains/cloud-v2/luau-execution-tasks/specs.ts\";\nimport type {\n\tGetParameters,\n\tLuauExecutionTask,\n\tLuauExecutionTaskRef,\n\tSubmitAtHeadParameters,\n\tSubmitAtVersionParameters,\n} from \"../../domains/cloud-v2/luau-execution-tasks/types.ts\";\nimport type { OpenCloudError } from \"../../errors/base.ts\";\nimport { CREATE_METHOD_DEFAULTS } from \"../../internal/http/retry.ts\";\nimport {\n\tokRequest,\n\tResourceClient,\n\ttype ResourceMethodSpec,\n} from \"../../internal/resource-client.ts\";\nimport type { Result } from \"../../types.ts\";\nimport { buildPollDeps, submitAndPoll } from \"./polling-helpers.ts\";\nimport { pollUntilDoneCore, type PollUntilDoneOptions } from \"./polling.ts\";\n\nfunction makeSpec<P, R>(spec: ResourceMethodSpec<P, R>): ResourceMethodSpec<P, R> {\n\treturn Object.freeze(spec);\n}\n\nconst CREATE_BINARY_INPUT_SPEC = makeSpec<\n\tCreateBinaryInputParameters,\n\tLuauExecutionTaskBinaryInput\n>({\n\tbuildRequest: (parameters) => okRequest(buildCreateBinaryInputRequest(parameters)),\n\tmethodDefaults: CREATE_METHOD_DEFAULTS,\n\tmethodKind: \"create\",\n\toperationLimit: CREATE_OPERATION_LIMIT,\n\tparse: parseBinaryInputResponse,\n\trequiredScopes: CREATE_REQUIRED_SCOPES,\n});\n\n/**\n * Operation handle for the `binaryInputs` namespace on\n * {@link LuauExecutionClient}. Provides `create` to allocate a presigned\n * upload slot for binary script inputs.\n */\nexport interface BinaryInputsHandle {\n\t/**\n\t * Allocates a presigned binary input upload slot. The returned\n\t * `uploadUri` is a presigned `PUT` target; the caller uploads the\n\t * binary data directly and passes `path` to `tasks.submit` as\n\t * `binaryInput`.\n\t *\n\t * @param parameters - Universe identifier and the byte size of the\n\t *   binary to upload.\n\t * @param options - Optional per-request overrides.\n\t * @returns A {@link Result} wrapping the parsed\n\t *   {@link LuauExecutionTaskBinaryInput} or the {@link OpenCloudError}\n\t *   that caused the request to fail.\n\t */\n\tcreate(\n\t\tparameters: CreateBinaryInputParameters,\n\t\toptions?: RequestOptions,\n\t): Promise<Result<LuauExecutionTaskBinaryInput, OpenCloudError>>;\n}\n\n/**\n * Operation handle exposed by {@link LuauExecutionClient} as the\n * `tasks` namespace. Provides `submit` to queue a Luau script, `get`\n * to fetch a task's current state, and `listLogs` to retrieve\n * structured log messages produced by a task.\n */\nexport interface TasksHandle {\n\t/**\n\t * Fetches the current state of a previously-submitted Luau\n\t * execution task. Uses idempotent retry semantics for both 429 and\n\t * 5xx.\n\t *\n\t * @param parameters - The task ref plus an optional `view` selector.\n\t * @param options - Optional per-request overrides (e.g. A different\n\t *   {@link OpenCloudClientOptions.apiKey} for this call only).\n\t * @returns A {@link Result} wrapping the parsed\n\t *   {@link LuauExecutionTask} or the {@link OpenCloudError} that\n\t *   caused the request to fail.\n\t */\n\tget(\n\t\tparameters: GetParameters,\n\t\toptions?: RequestOptions,\n\t): Promise<Result<LuauExecutionTask, OpenCloudError>>;\n\t/**\n\t * Lists one page of structured log messages produced by a\n\t * previously-submitted Luau execution task. Messages from multiple\n\t * server-side chunks are flattened into a single ordered array.\n\t * Uses idempotent retry semantics for both 429 and 5xx.\n\t *\n\t * @param parameters - The task ref and optional pagination controls\n\t *   (`pageSize`, `pageToken`).\n\t * @param options - Optional per-request overrides (e.g. A different\n\t *   {@link OpenCloudClientOptions.apiKey} for this call only).\n\t * @returns A {@link Result} wrapping the parsed {@link LogPage} or\n\t *   the {@link OpenCloudError} that caused the request to fail.\n\t */\n\tlistLogs(\n\t\tparameters: ListLogsParameters,\n\t\toptions?: RequestOptions,\n\t): Promise<Result<LogPage, OpenCloudError>>;\n\t/**\n\t * Polls `tasks.get` with `view=BASIC` on a configurable backoff schedule\n\t * until the task reaches a terminal state, the wall-clock budget is\n\t * exhausted, or the supplied `AbortSignal` fires. Returns the terminal\n\t * task on success.\n\t *\n\t * @param ref - Reference to the task to poll, typically returned by `submit`.\n\t * @param options - Polling and per-request overrides.\n\t * @returns A {@link Result} wrapping the terminal {@link LuauExecutionTask},\n\t *   or an error if aborted, timed out, or the transport fails.\n\t */\n\tpollUntilDone(\n\t\tref: LuauExecutionTaskRef,\n\t\toptions?: PollUntilDoneOptions,\n\t): Promise<Result<LuauExecutionTask, OpenCloudError>>;\n\t/**\n\t * Submits a Luau script and polls `tasks.get` with `view=BASIC` until\n\t * the task reaches a terminal state, the wall-clock budget is\n\t * exhausted, or the supplied `AbortSignal` fires. Combines `submit`\n\t * and `pollUntilDone` in one call.\n\t *\n\t * @param parameters - The same input accepted by `submit`.\n\t * @param options - Polling and per-request overrides.\n\t * @returns A {@link Result} wrapping the terminal\n\t *   {@link LuauExecutionTask}, or an error if submit fails, the task\n\t *   is aborted, timed out, or the transport fails.\n\t */\n\trunUntilDone(\n\t\tparameters: SubmitAtHeadParameters | SubmitAtVersionParameters,\n\t\toptions?: PollUntilDoneOptions,\n\t): Promise<Result<LuauExecutionTask, OpenCloudError>>;\n\t/**\n\t * Submits a Luau script for execution against a place. Dispatches\n\t * to the head-version URL when `versionId` is omitted, or to the\n\t * specific-version URL when one is supplied. Both URL shapes share\n\t * one rate-limit queue and one required-scope set.\n\t *\n\t * @param parameters - The universe and place identifiers, the\n\t *   script to run, an optional `versionId`, and any other writable\n\t *   submit fields.\n\t * @param options - Optional per-request overrides (e.g. A different\n\t *   {@link OpenCloudClientOptions.apiKey} for this call only).\n\t * @returns A {@link Result} wrapping the parsed\n\t *   {@link LuauExecutionTask} or the {@link OpenCloudError} that\n\t *   caused the request to fail.\n\t */\n\tsubmit(\n\t\tparameters: SubmitAtHeadParameters | SubmitAtVersionParameters,\n\t\toptions?: RequestOptions,\n\t): Promise<Result<LuauExecutionTask, OpenCloudError>>;\n}\n\n/**\n * Public client for the Roblox Open Cloud `LuauExecutionSessionTask`\n * resource. Tasks run a Luau script against a place and surface state,\n * output, or error through the `LuauExecutionTask` discriminated\n * union. Exposes `tasks.submit` for both the head version and a\n * specific place version, `tasks.get` for fetching task state,\n * `tasks.listLogs` for fetching structured log messages, and\n * `binaryInputs.create` for allocating presigned upload slots.\n */\nexport class LuauExecutionClient {\n\treadonly #inner: ResourceClient;\n\n\tpublic readonly binaryInputs: BinaryInputsHandle;\n\tpublic readonly tasks: TasksHandle;\n\n\t/**\n\t * Creates a new {@link LuauExecutionClient}. Configuration is frozen\n\t * on construction; per-request overrides are accepted on each\n\t * method.\n\t *\n\t * @param options - Client-level configuration including the API key.\n\t */\n\tconstructor(options: OpenCloudClientOptions) {\n\t\tthis.#inner = new ResourceClient(options);\n\t\tthis.binaryInputs = createBinaryInputsHandle(this.#inner);\n\t\tthis.tasks = createTasksHandle(this.#inner);\n\t}\n}\n\nfunction createBinaryInputsHandle(inner: ResourceClient): BinaryInputsHandle {\n\treturn {\n\t\tasync create(parameters, options) {\n\t\t\treturn inner.execute({ options, parameters, spec: CREATE_BINARY_INPUT_SPEC });\n\t\t},\n\t};\n}\n\nfunction createTasksHandle(inner: ResourceClient): TasksHandle {\n\treturn {\n\t\tasync get(parameters, options) {\n\t\t\treturn inner.execute({ options, parameters, spec: GET_SPEC });\n\t\t},\n\t\tasync listLogs(parameters, options) {\n\t\t\treturn inner.execute({ options, parameters, spec: LIST_LOGS_SPEC });\n\t\t},\n\t\tasync pollUntilDone(ref, options = {}) {\n\t\t\treturn pollUntilDoneCore(buildPollDeps(inner, { options, ref }), options);\n\t\t},\n\t\tasync runUntilDone(parameters, options = {}) {\n\t\t\treturn submitAndPoll(inner, { options, parameters });\n\t\t},\n\t\tasync submit(parameters, options) {\n\t\t\tif (\"versionId\" in parameters) {\n\t\t\t\treturn inner.execute({ options, parameters, spec: SUBMIT_VERSION_SPEC });\n\t\t\t}\n\n\t\t\treturn inner.execute({ options, parameters, spec: SUBMIT_HEAD_SPEC });\n\t\t},\n\t};\n}\n"],"mappings":";;;;;;;;;;;;;AAYA,SAAgB,8BACf,YACc;CACd,MAAM,EAAE,MAAM,eAAe;AAC7B,QAAO;EACN,MAAM,EAAE,MAAM;EACd,SAAS,EAAE,gBAAgB,oBAAoB;EAC/C,QAAQ;EACR,KAAK,uBAAuB,WAAW;EACvC;;;;;;;;ACVF,MAAa,yBAAyC,OAAO,OAAO;CACnE,cAVyB,IACC;CAU1B,cAAc;CACd,CAAC;;;;;;AAOF,MAAa,yBAAgD,OAAO,OAAO,CAC1E,8CACA,CAAC;;;ACjBF,MAAM,eAAe;AAErB,MAAM,oBAAoB;;;;;;;;;;AAW1B,SAAgB,yBACf,UACiD;CACjD,MAAM,EAAE,MAAM,QAAQ,eAAe;AAErC,KAAI,CAAC,SAAS,KAAK,CAClB,QAAO,UAAU,WAAW;AAG7B,KAAI,OAAO,KAAK,YAAY,YAAY,CAAC,aAAa,KAAK,KAAK,QAAQ,CACvE,QAAO,UAAU,WAAW;AAG7B,KAAI,OAAO,KAAK,iBAAiB,SAChC,QAAO,UAAU,WAAW;AAG7B,QAAO;EACN,MAAM;GAAE,MAAM,KAAK;GAAS,WAAW,KAAK;GAAc;EAC1D,SAAS;EACT;;AAGF,SAAS,UAAU,YAAoE;AACtF,QAAO;EAAE,KAAK,IAAI,SAAS,mBAAmB,EAAE,YAAY,CAAC;EAAE,SAAS;EAAO;;;;ACJhF,SAAS,SAAe,MAA0D;AACjF,QAAO,OAAO,OAAO,KAAK;;AAG3B,MAAM,2BAA2B,SAG/B;CACD,eAAe,eAAe,UAAU,8BAA8B,WAAW,CAAC;CAClF,gBAAgB;CAChB,YAAY;CACZ,gBAAgB;CAChB,OAAO;CACP,gBAAgB;CAChB,CAAC;;;;;;;;;;AAgIF,IAAa,sBAAb,MAAiC;CAChC;CAEA;CACA;;;;;;;;CASA,YAAY,SAAiC;AAC5C,QAAA,QAAc,IAAI,eAAe,QAAQ;AACzC,OAAK,eAAe,yBAAyB,MAAA,MAAY;AACzD,OAAK,QAAQ,kBAAkB,MAAA,MAAY;;;AAI7C,SAAS,yBAAyB,OAA2C;AAC5E,QAAO,EACN,MAAM,OAAO,YAAY,SAAS;AACjC,SAAO,MAAM,QAAQ;GAAE;GAAS;GAAY,MAAM;GAA0B,CAAC;IAE9E;;AAGF,SAAS,kBAAkB,OAAoC;AAC9D,QAAO;EACN,MAAM,IAAI,YAAY,SAAS;AAC9B,UAAO,MAAM,QAAQ;IAAE;IAAS;IAAY,MAAM;IAAU,CAAC;;EAE9D,MAAM,SAAS,YAAY,SAAS;AACnC,UAAO,MAAM,QAAQ;IAAE;IAAS;IAAY,MAAM;IAAgB,CAAC;;EAEpE,MAAM,cAAc,KAAK,UAAU,EAAE,EAAE;AACtC,UAAO,kBAAkB,cAAc,OAAO;IAAE;IAAS;IAAK,CAAC,EAAE,QAAQ;;EAE1E,MAAM,aAAa,YAAY,UAAU,EAAE,EAAE;AAC5C,UAAO,cAAc,OAAO;IAAE;IAAS;IAAY,CAAC;;EAErD,MAAM,OAAO,YAAY,SAAS;AACjC,OAAI,eAAe,WAClB,QAAO,MAAM,QAAQ;IAAE;IAAS;IAAY,MAAM;IAAqB,CAAC;AAGzE,UAAO,MAAM,QAAQ;IAAE;IAAS;IAAY,MAAM;IAAkB,CAAC;;EAEtE"}

package/dist/places.d.mts

@@ -1,4 +1,5 @@
-import { d as OpenCloudError, i as OpenCloudClientOptions, l as Result, s as RequestOptions } from "./types-YCTsM8Qd.mjs";
+import { d as OpenCloudError, i as OpenCloudClientOptions, l as Result, s as RequestOptions } from "./types-DUzm6maA.mjs";
+import { d as SubmitAtHeadParameters, f as SubmitAtVersionParameters, i as LogPage, l as LuauExecutionTask, n as ListLogsParameters, r as LogMessage, s as GetParameters, t as PollUntilDoneOptions, u as LuauExecutionTaskRef } from "./polling-Cc50rgl6.mjs";
 
 //#region src/domains/cloud-v2/places/types.d.ts
 /**
@@ -80,13 +81,90 @@ interface PlaceVersion {
 //#endregion
 //#region src/resources/places/client.d.ts
 /**
+* Operation Group exposed by {@link PlacesClient} as the
+* `luauExecution` namespace. Provides `submit` to queue a Luau script,
+* `get` to fetch a task's current state, and `listLogs` to retrieve
+* structured log messages. Shares the same dispatch wiring as the
+* top-level `LuauExecutionClient` exposed at
+* `@bedrock-rbx/ocale/luau-execution`.
+*/
+interface LuauExecutionHandle {
+  /**
+  * Fetches the current state of a previously-submitted Luau
+  * execution task. Uses idempotent retry semantics for both 429 and
+  * 5xx.
+  *
+  * @param parameters - The task ref plus an optional `view` selector.
+  * @param options - Optional per-request overrides (e.g. A different
+  *   {@link OpenCloudClientOptions.apiKey} for this call only).
+  * @returns A {@link Result} wrapping the parsed
+  *   {@link LuauExecutionTask} or the {@link OpenCloudError} that
+  *   caused the request to fail.
+  */
+  get(parameters: GetParameters, options?: RequestOptions): Promise<Result<LuauExecutionTask, OpenCloudError>>;
+  /**
+  * Lists one page of structured log messages produced by a
+  * previously-submitted Luau execution task. Messages from multiple
+  * server-side chunks are flattened into a single ordered array.
+  * Uses idempotent retry semantics for both 429 and 5xx.
+  *
+  * @param parameters - The task ref and optional pagination controls
+  *   (`pageSize`, `pageToken`).
+  * @param options - Optional per-request overrides (e.g. A different
+  *   {@link OpenCloudClientOptions.apiKey} for this call only).
+  * @returns A {@link Result} wrapping the parsed {@link LogPage} or
+  *   the {@link OpenCloudError} that caused the request to fail.
+  */
+  listLogs(parameters: ListLogsParameters, options?: RequestOptions): Promise<Result<LogPage, OpenCloudError>>;
+  /**
+  * Polls `get` with `view=BASIC` on a configurable backoff schedule until
+  * the task reaches a terminal state, the wall-clock budget is exhausted,
+  * or the supplied `AbortSignal` fires. Returns the terminal task on
+  * success.
+  *
+  * @param ref - Reference to the task to poll, typically returned by `submit`.
+  * @param options - Polling and per-request overrides.
+  * @returns A {@link Result} wrapping the terminal {@link LuauExecutionTask},
+  *   or an error if aborted, timed out, or the transport fails.
+  */
+  pollUntilDone(ref: LuauExecutionTaskRef, options?: PollUntilDoneOptions): Promise<Result<LuauExecutionTask, OpenCloudError>>;
+  /**
+  * Submits a Luau script and polls `get` with `view=BASIC` until the
+  * task reaches a terminal state, the wall-clock budget is exhausted,
+  * or the supplied `AbortSignal` fires. Combines `submit` and
+  * `pollUntilDone` in one call.
+  *
+  * @param parameters - The same input accepted by `submit`.
+  * @param options - Polling and per-request overrides.
+  * @returns A {@link Result} wrapping the terminal
+  *   {@link LuauExecutionTask}, or an error if submit fails, the task
+  *   is aborted, timed out, or the transport fails.
+  */
+  runUntilDone(parameters: SubmitAtHeadParameters | SubmitAtVersionParameters, options?: PollUntilDoneOptions): Promise<Result<LuauExecutionTask, OpenCloudError>>;
+  /**
+  * Submits a Luau script for execution against a place. Dispatches
+  * to the head-version URL when `versionId` is omitted, or to the
+  * specific-version URL when one is supplied. Both URL shapes share
+  * one rate-limit queue and one required-scope set.
+  *
+  * @param parameters - The universe and place identifiers, the
+  *   script to run, an optional `versionId`, and any other writable
+  *   submit fields.
+  * @param options - Optional per-request overrides (e.g. A different
+  *   {@link OpenCloudClientOptions.apiKey} for this call only).
+  * @returns A {@link Result} wrapping the parsed
+  *   {@link LuauExecutionTask} or the {@link OpenCloudError} that
+  *   caused the request to fail.
+  */
+  submit(parameters: SubmitAtHeadParameters | SubmitAtVersionParameters, options?: RequestOptions): Promise<Result<LuauExecutionTask, OpenCloudError>>;
+}
+/**
 * Public client for the Roblox Open Cloud `Place` resource. Covers
-* place-version publishing (`publish`, `save`) and place-configuration
-* updates (`update`). Wires the request builders, the injected
-* {@link OpenCloudClientOptions.httpClient}, and the response parsers
-* into a single ergonomic surface. Every method returns a {@link Result}
-* so callers handle failure explicitly; no thrown {@link OpenCloudError}
-* ever escapes the client.
+* place-version publishing (`publish`, `save`), place-configuration
+* updates (`update`), and the Luau execution Operation Group
+* (`luauExecution.submit`, `luauExecution.get`). Every method returns
+* a {@link Result} so callers handle failure explicitly; no thrown
+* {@link OpenCloudError} ever escapes the client.
 *
 * Publishing or saving a 5xx-failed place version is not retried
 * automatically: Roblox does not support idempotency keys, so a retry
@@ -106,6 +184,7 @@ interface PlaceVersion {
 */
 declare class PlacesClient {
   #private;
+  readonly luauExecution: LuauExecutionHandle;
   /**
   * Creates a new {@link PlacesClient}. Configuration is frozen on
   * construction; per-request overrides are accepted on each method.
@@ -157,5 +236,5 @@ declare class PlacesClient {
   update(parameters: UpdatePlaceParameters, options?: RequestOptions): Promise<Result<Place, OpenCloudError>>;
 }
 //#endregion
-export { type Place, type PlaceVersion, PlacesClient, type PublishParameters, type UpdatePlaceParameters };
+export { type ListLogsParameters, type LogMessage, type LogPage, type LuauExecutionHandle, type Place, type PlaceVersion, PlacesClient, type PublishParameters, type UpdatePlaceParameters };
 //# sourceMappingURL=places.d.mts.map

package/dist/places.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"places.d.mts","names":[],"sources":["../src/domains/cloud-v2/places/types.ts","../src/domains/universes/places/types.ts","../src/resources/places/client.ts"],"mappings":";;;;;;AAMA;;;UAAiB,qBAAA;;WAEP,WAAA;;WAEA,WAAA;;WAEA,OAAA;EAIA;EAAA,SAFA,UAAA;EASO;EAAA,SAPP,UAAA;AAAA;;;;;UAOO,KAAA;;WAEP,EAAA;;WAEA,SAAA,EAAW,IAAA;;WAEX,WAAA;;WAEA,WAAA;;WAEA,IAAA;;WAEA,UAAA;EC7BO;EAAA,SD+BP,UAAA;EC7BM;EAAA,SD+BN,uBAAA;;WAEA,SAAA,EAAW,IAAA;AAAA;;;;;;AAnCrB;;;UCAiB,iBAAA;;WAEP,IAAA,EAAM,UAAA,CAAW,WAAA;;;;;;ADe3B;WCRU,MAAA;;WAEA,OAAA;;WAEA,UAAA;AAAA;;;;UAMO,YAAA;;;;;;WAMP,aAAA;AAAA;;;;;;;;;;;;ADRV;;;;;;;;;;;;;;;;cEgDa,YAAA;EAAA;;;ADjEb;;;;EC0EC,WAAA,CAAY,OAAA,EAAS,sBAAA;;;;;;;;ADvDtB;;;ECqEC,OAAA,CACC,UAAA,EAAY,iBAAA,EACZ,OAAA,GAAU,cAAA,GACR,OAAA,CAAQ,MAAA,CAAO,YAAA,EAAc,cAAA;EDlEvB;;;;ACwCV;;;;;;;;;;EA4CC,IAAA,CACC,UAAA,EAAY,iBAAA,EACZ,OAAA,GAAU,cAAA,GACR,OAAA,CAAQ,MAAA,CAAO,YAAA,EAAc,cAAA;;;;;;;;;;;;;;;;EAmBhC,MAAA,CACC,UAAA,EAAY,qBAAA,EACZ,OAAA,GAAU,cAAA,GACR,OAAA,CAAQ,MAAA,CAAO,KAAA,EAAO,cAAA;AAAA"}
+{"version":3,"file":"places.d.mts","names":[],"sources":["../src/domains/cloud-v2/places/types.ts","../src/domains/universes/places/types.ts","../src/resources/places/client.ts"],"mappings":";;;;;;;;AAMA;;UAAiB,qBAAA;EAAA;EAAA,SAEP,WAAA;;WAEA,WAAA;;WAEA,OAAA;;WAEA,UAAA;EASV;EAAA,SAPU,UAAA;AAAA;;;;;UAOO,KAAA;;WAEP,EAAA;;WAEA,SAAA,EAAW,IAAA;;WAEX,WAAA;;WAEA,WAAA;EAUW;EAAA,SARX,IAAA;;WAEA,UAAA;EC7BV;EAAA,SD+BU,UAAA;;WAEA,uBAAA;;WAEA,SAAA,EAAW,IAAA;AAAA;;;;;;;AAnCrB;;UCAiB,iBAAA;EDAA;EAAA,SCEP,IAAA,EAAM,UAAA,CAAW,WAAA;;;;;;;WAOjB,MAAA;EDQO;EAAA,SCNP,OAAA;EDwBW;EAAA,SCtBX,UAAA;AAAA;;;;UAMO,YAAA;;;;;;WAMP,aAAA;AAAA;;;;;;;;;;ADRV;UEwBiB,mBAAA;;;;;;;;;;;;;EAahB,GAAA,CACC,UAAA,EAAY,aAAA,EACZ,OAAA,GAAU,cAAA,GACR,OAAA,CAAQ,MAAA,CAAO,iBAAA,EAAmB,cAAA;;;;;;ADzDtC;;;;;;;;ECuEC,QAAA,CACC,UAAA,EAAY,kBAAA,EACZ,OAAA,GAAU,cAAA,GACR,OAAA,CAAQ,MAAA,CAAO,OAAA,EAAS,cAAA;;;;ADvD5B;;;;;;;;ECmEC,aAAA,CACC,GAAA,EAAK,oBAAA,EACL,OAAA,GAAU,oBAAA,GACR,OAAA,CAAQ,MAAA,CAAO,iBAAA,EAAmB,cAAA;EAhDrB;;;;;;;;;;;;EA6DhB,YAAA,CACC,UAAA,EAAY,sBAAA,GAAyB,yBAAA,EACrC,OAAA,GAAU,oBAAA,GACR,OAAA,CAAQ,MAAA,CAAO,iBAAA,EAAmB,cAAA;;;;;;;;;;;;;;;;EAgBrC,MAAA,CACC,UAAA,EAAY,sBAAA,GAAyB,yBAAA,EACrC,OAAA,GAAU,cAAA,GACR,OAAA,CAAQ,MAAA,CAAO,iBAAA,EAAmB,cAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;cAqDzB,YAAA;EAAA;WAGI,aAAA,EAAe,mBAAA;;;;;;;EAQ/B,WAAA,CAAY,OAAA,EAAS,sBAAA;;;;;;;;;;;EAerB,OAAA,CACC,UAAA,EAAY,iBAAA,EACZ,OAAA,GAAU,cAAA,GACR,OAAA,CAAQ,MAAA,CAAO,YAAA,EAAc,cAAA;;;;;;;;;;;AA7BjC;;;;EA+CC,IAAA,CACC,UAAA,EAAY,iBAAA,EACZ,OAAA,GAAU,cAAA,GACR,OAAA,CAAQ,MAAA,CAAO,YAAA,EAAc,cAAA;;;;;;;;;;;;;;;;EAmBhC,MAAA,CACC,UAAA,EAAY,qBAAA,EACZ,OAAA,GAAU,cAAA,GACR,OAAA,CAAQ,MAAA,CAAO,KAAA,EAAO,cAAA;AAAA"}

package/dist/places.mjs

@@ -1,6 +1,8 @@
-import { i as ApiError } from "./rate-limit-BBU_4xnZ.mjs";
-import { t as ValidationError } from "./validation-CTZzJhmd.mjs";
-import { i as CREATE_METHOD_DEFAULTS, o as isRecord, t as ResourceClient } from "./resource-client-CaS_j3yg.mjs";
+import { i as ApiError } from "./rate-limit-CKfuhxT1.mjs";
+import { t as ValidationError } from "./validation-VImVHzxg.mjs";
+import { t as isDateTimeString } from "./is-date-time-string-Ds8Ew-Xa.mjs";
+import { i as CREATE_METHOD_DEFAULTS, s as isRecord, t as ResourceClient } from "./resource-client-opC6BUkL.mjs";
+import { a as SUBMIT_HEAD_SPEC, i as GET_SPEC, n as submitAndPoll, o as SUBMIT_VERSION_SPEC, r as pollUntilDoneCore, s as LIST_LOGS_SPEC, t as buildPollDeps } from "./polling-helpers-BVkmr6C7.mjs";
 //#region src/domains/cloud-v2/places/builders.ts
 const NON_UPDATABLE_KEYS = new Set(["placeId", "universeId"]);
 /**
@@ -102,7 +104,7 @@ function toPlace(args) {
 	};
 }
 function hasValidPlaceRequired(body) {
-	return typeof body["path"] === "string" && typeof body["createTime"] === "string" && typeof body["updateTime"] === "string" && typeof body["displayName"] === "string" && typeof body["description"] === "string";
+	return typeof body["path"] === "string" && isDateTimeString(body["createTime"]) && isDateTimeString(body["updateTime"]) && typeof body["displayName"] === "string" && typeof body["description"] === "string";
 }
 function isOptionalBoolean(value) {
 	return value === void 0 || value === null || typeof value === "boolean";
@@ -280,7 +282,7 @@ function isPlaceVersionWire(value) {
 }
 //#endregion
 //#region src/resources/places/client.ts
-function makeSpec(versionType) {
+function makePublishSpec(versionType) {
 	return Object.freeze({
 		buildRequest: (parameters) => buildPublishRequest(parameters, versionType),
 		methodDefaults: CREATE_METHOD_DEFAULTS,
@@ -290,8 +292,8 @@ function makeSpec(versionType) {
 		requiredScopes: PUBLISH_REQUIRED_SCOPES
 	});
 }
-const PUBLISH_SPEC = makeSpec("Published");
-const SAVE_SPEC = makeSpec("Saved");
+const PUBLISH_SPEC = makePublishSpec("Published");
+const SAVE_SPEC = makePublishSpec("Saved");
 const UPDATE_SPEC = Object.freeze({
 	buildRequest: buildUpdateRequest,
 	methodDefaults: {},
@@ -302,12 +304,11 @@ const UPDATE_SPEC = Object.freeze({
 });
 /**
 * Public client for the Roblox Open Cloud `Place` resource. Covers
-* place-version publishing (`publish`, `save`) and place-configuration
-* updates (`update`). Wires the request builders, the injected
-* {@link OpenCloudClientOptions.httpClient}, and the response parsers
-* into a single ergonomic surface. Every method returns a {@link Result}
-* so callers handle failure explicitly; no thrown {@link OpenCloudError}
-* ever escapes the client.
+* place-version publishing (`publish`, `save`), place-configuration
+* updates (`update`), and the Luau execution Operation Group
+* (`luauExecution.submit`, `luauExecution.get`). Every method returns
+* a {@link Result} so callers handle failure explicitly; no thrown
+* {@link OpenCloudError} ever escapes the client.
 *
 * Publishing or saving a 5xx-failed place version is not retried
 * automatically: Roblox does not support idempotency keys, so a retry
@@ -327,6 +328,7 @@ const UPDATE_SPEC = Object.freeze({
 */
 var PlacesClient = class {
 	#inner;
+	luauExecution;
 	/**
 	* Creates a new {@link PlacesClient}. Configuration is frozen on
 	* construction; per-request overrides are accepted on each method.
@@ -335,6 +337,7 @@ var PlacesClient = class {
 	*/
 	constructor(options) {
 		this.#inner = new ResourceClient(options);
+		this.luauExecution = createLuauExecutionHandle(this.#inner);
 	}
 	/**
 	* Publishes a new live version of a place.
@@ -397,6 +400,48 @@ var PlacesClient = class {
 		});
 	}
 };
+function createLuauExecutionHandle(inner) {
+	return {
+		async get(parameters, options) {
+			return inner.execute({
+				options,
+				parameters,
+				spec: GET_SPEC
+			});
+		},
+		async listLogs(parameters, options) {
+			return inner.execute({
+				options,
+				parameters,
+				spec: LIST_LOGS_SPEC
+			});
+		},
+		async pollUntilDone(ref, options = {}) {
+			return pollUntilDoneCore(buildPollDeps(inner, {
+				options,
+				ref
+			}), options);
+		},
+		async runUntilDone(parameters, options = {}) {
+			return submitAndPoll(inner, {
+				options,
+				parameters
+			});
+		},
+		async submit(parameters, options) {
+			if ("versionId" in parameters) return inner.execute({
+				options,
+				parameters,
+				spec: SUBMIT_VERSION_SPEC
+			});
+			return inner.execute({
+				options,
+				parameters,
+				spec: SUBMIT_HEAD_SPEC
+			});
+		}
+	};
+}
 //#endregion
 export { PlacesClient };