@statelyai/sdk 0.34.2 → 0.35.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +17 -34
- package/dist/assetStorage.d.mts +1 -1
- package/dist/auth.d.mts +14 -1
- package/dist/bin.mjs +1 -3
- package/dist/editor-sync-types-DNFk7Xtj.d.mts +53 -0
- package/dist/editorHostProtocol.d.mts +197 -0
- package/dist/{editorHostProtocol-B2_t3Le7.mjs → editorHostProtocol.mjs} +1 -1
- package/dist/embed.d.mts +3 -3
- package/dist/embed.mjs +2 -2
- package/dist/{graph-DVfx7FwN.d.mts → graph-B6xUxqR5.d.mts} +1 -1
- package/dist/graph.d.mts +1 -1
- package/dist/{index-A5CMACoO.d.mts → index-CoxF4Saw.d.mts} +8 -255
- package/dist/index.d.mts +8 -31
- package/dist/index.mjs +5 -9
- package/dist/{inspect-DBH9oOAd.d.mts → inspect-DCdu0ST3.d.mts} +1 -1
- package/dist/{inspect-ZVDq9tK2.mjs → inspect-GSXRhzOx.mjs} +1 -1
- package/dist/inspect.d.mts +2 -2
- package/dist/inspect.mjs +2 -2
- package/dist/patchTypes.d.mts +1 -1
- package/dist/{protocol-CCf9j_SZ.d.mts → protocol-nOWsz3UV.d.mts} +3 -3
- package/dist/protocol.d.mts +1 -1
- package/dist/relay.d.mts +1 -1
- package/dist/{studio-CFN3-0-2.d.mts → studio-3ujfe2z0.d.mts} +2 -2
- package/dist/{openapi-BTDjYWXd.mjs → studio-Bn3alVku.mjs} +637 -1
- package/dist/studio.d.mts +1 -1
- package/dist/studio.mjs +2 -2
- package/dist/{version-CUFh-PYe.mjs → version-DECst76A.mjs} +1 -1
- package/package.json +18 -14
- package/dist/auth-CVFc85uF.d.mts +0 -15
- package/dist/dist-DsOTTfYv.mjs +0 -8361
- package/dist/editor-sync-types-D7YYz6fb.d.mts +0 -98
- package/dist/editorHostSession-DCTHhBqC.mjs +0 -912
- package/dist/editorHostSession-yGUKdLjq.d.mts +0 -325
- package/dist/editorHostSession.d.mts +0 -2
- package/dist/editorHostSession.mjs +0 -6
- package/dist/statelyPragma-YtVaBuIe.mjs +0 -102
- package/dist/studio-BZP6DaIO.mjs +0 -638
- package/dist/sync.d.mts +0 -86
- package/dist/sync.mjs +0 -4646
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
import { createAuthorizationHeader, getCredentialToken } from "./auth.mjs";
|
|
2
|
+
|
|
1
3
|
//#region \0rolldown/runtime.js
|
|
2
4
|
var __defProp = Object.defineProperty;
|
|
3
5
|
var __commonJSMin = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
|
|
@@ -13947,4 +13949,638 @@ var import_dist = require_dist();
|
|
|
13947
13949
|
(0, import_dist.extendZodWithOpenApi)(external_exports);
|
|
13948
13950
|
|
|
13949
13951
|
//#endregion
|
|
13950
|
-
|
|
13952
|
+
//#region ../api-contract/dist/errors.mjs
|
|
13953
|
+
/**
|
|
13954
|
+
* Error shape returned by every `/api/v1` machine operation (and by the shared
|
|
13955
|
+
* auth guard). Each operation registers its own error schema component in the
|
|
13956
|
+
* OpenAPI document, so this is a factory rather than a single shared instance.
|
|
13957
|
+
*/
|
|
13958
|
+
function createApiErrorResponseSchema() {
|
|
13959
|
+
return object({
|
|
13960
|
+
error: string$1(),
|
|
13961
|
+
issues: array(unknown()).optional()
|
|
13962
|
+
});
|
|
13963
|
+
}
|
|
13964
|
+
const apiErrorResponseSchema = createApiErrorResponseSchema();
|
|
13965
|
+
/**
|
|
13966
|
+
* Canonical error codes for the `/api/v1` resource operations. Machine
|
|
13967
|
+
* operations keep the flat `{ error: string }` shape above unchanged; the
|
|
13968
|
+
* nested envelope below applies to resource operations only.
|
|
13969
|
+
*/
|
|
13970
|
+
const resourceErrorCodeSchema = _enum([
|
|
13971
|
+
"bad_request",
|
|
13972
|
+
"unauthenticated",
|
|
13973
|
+
"forbidden",
|
|
13974
|
+
"not_found",
|
|
13975
|
+
"conflict",
|
|
13976
|
+
"payload_too_large",
|
|
13977
|
+
"rate_limited",
|
|
13978
|
+
"capability_disabled",
|
|
13979
|
+
"upstream_error",
|
|
13980
|
+
"internal_error"
|
|
13981
|
+
]);
|
|
13982
|
+
/** Factory, matching `createApiErrorResponseSchema`, for per-route OpenAPI components. */
|
|
13983
|
+
function createResourceApiErrorResponseSchema() {
|
|
13984
|
+
return object({ error: object({
|
|
13985
|
+
code: resourceErrorCodeSchema,
|
|
13986
|
+
message: string$1(),
|
|
13987
|
+
issues: array(unknown()).optional(),
|
|
13988
|
+
retryable: boolean$1().optional()
|
|
13989
|
+
}) });
|
|
13990
|
+
}
|
|
13991
|
+
const resourceApiErrorResponseSchema = createResourceApiErrorResponseSchema();
|
|
13992
|
+
|
|
13993
|
+
//#endregion
|
|
13994
|
+
//#region ../api-contract/dist/xgraph.mjs
|
|
13995
|
+
const looseRecordSchema = record(string$1(), unknown());
|
|
13996
|
+
const pointSchema = object({
|
|
13997
|
+
x: number$1(),
|
|
13998
|
+
y: number$1()
|
|
13999
|
+
});
|
|
14000
|
+
const nodeDataSchema = looseRecordSchema.refine((data) => !("parentId" in data), "XGraph node data must not contain parentId; use node.parentId.");
|
|
14001
|
+
const xgraphNodeSchema = object({
|
|
14002
|
+
id: string$1(),
|
|
14003
|
+
type: string$1().optional(),
|
|
14004
|
+
parentId: string$1().nullable().optional(),
|
|
14005
|
+
sourceId: string$1().optional(),
|
|
14006
|
+
targetId: string$1().optional(),
|
|
14007
|
+
label: string$1().nullable().optional(),
|
|
14008
|
+
data: nodeDataSchema.optional(),
|
|
14009
|
+
x: number$1().optional(),
|
|
14010
|
+
y: number$1().optional(),
|
|
14011
|
+
width: number$1().optional(),
|
|
14012
|
+
height: number$1().optional(),
|
|
14013
|
+
position: pointSchema.optional(),
|
|
14014
|
+
dx: number$1().optional(),
|
|
14015
|
+
dy: number$1().optional()
|
|
14016
|
+
}).passthrough();
|
|
14017
|
+
const xgraphEdgeSchema = object({
|
|
14018
|
+
id: string$1(),
|
|
14019
|
+
type: string$1().optional(),
|
|
14020
|
+
sourceId: string$1(),
|
|
14021
|
+
targetId: string$1(),
|
|
14022
|
+
label: string$1().nullable().optional(),
|
|
14023
|
+
data: unknown(),
|
|
14024
|
+
x: number$1().optional(),
|
|
14025
|
+
y: number$1().optional(),
|
|
14026
|
+
width: number$1().optional(),
|
|
14027
|
+
height: number$1().optional(),
|
|
14028
|
+
position: pointSchema.optional(),
|
|
14029
|
+
dx: number$1().optional(),
|
|
14030
|
+
dy: number$1().optional()
|
|
14031
|
+
}).passthrough();
|
|
14032
|
+
/** XGraph wire shape accepted and emitted at API boundaries. */
|
|
14033
|
+
const xgraphSchema = object({
|
|
14034
|
+
xgraphSchemaVersion: literal("1.0.0").optional(),
|
|
14035
|
+
id: string$1(),
|
|
14036
|
+
type: string$1().optional(),
|
|
14037
|
+
parentId: string$1().nullable().optional(),
|
|
14038
|
+
initialNodeId: string$1().nullable().optional(),
|
|
14039
|
+
nodes: array(xgraphNodeSchema),
|
|
14040
|
+
edges: array(xgraphEdgeSchema),
|
|
14041
|
+
data: unknown().optional(),
|
|
14042
|
+
layout: unknown().nullable().optional(),
|
|
14043
|
+
annotations: array(unknown()).optional(),
|
|
14044
|
+
direction: _enum([
|
|
14045
|
+
"up",
|
|
14046
|
+
"down",
|
|
14047
|
+
"left",
|
|
14048
|
+
"right"
|
|
14049
|
+
]).optional(),
|
|
14050
|
+
style: looseRecordSchema.optional()
|
|
14051
|
+
}).passthrough();
|
|
14052
|
+
|
|
14053
|
+
//#endregion
|
|
14054
|
+
//#region ../api-contract/dist/resources.mjs
|
|
14055
|
+
/**
|
|
14056
|
+
* Canonical schemas for persistent `/api/v1` resources plus the owned,
|
|
14057
|
+
* deterministic code-extraction operation.
|
|
14058
|
+
*
|
|
14059
|
+
* These models are canonical, not upstream-shaped: providers (e.g. the Stately
|
|
14060
|
+
* Registry adapter) are responsible for translating upstream envelopes,
|
|
14061
|
+
* identifier quirks and casing into these shapes. No `{ data }` envelope
|
|
14062
|
+
* appears anywhere; all timestamps are ISO strings.
|
|
14063
|
+
*/
|
|
14064
|
+
/**
|
|
14065
|
+
* XState major versions the editor targets (see
|
|
14066
|
+
* `packages/editor/src/formats/xstate.ts`).
|
|
14067
|
+
*/
|
|
14068
|
+
const xstateVersionSchema = union([literal(5), literal(6)]);
|
|
14069
|
+
const projectVisibilitySchema = _enum([
|
|
14070
|
+
"public",
|
|
14071
|
+
"unlisted",
|
|
14072
|
+
"private"
|
|
14073
|
+
]);
|
|
14074
|
+
const verifyResultSchema = object({
|
|
14075
|
+
valid: literal(true),
|
|
14076
|
+
tokenScope: _enum(["user", "project"])
|
|
14077
|
+
});
|
|
14078
|
+
/**
|
|
14079
|
+
* Entitlements for the authenticated caller.
|
|
14080
|
+
*
|
|
14081
|
+
* Internal contract: this is not published as an `/api/v1` operation. Editor
|
|
14082
|
+
* feature gating resolves it server-side through the resource provider and
|
|
14083
|
+
* hands the mapped result to the client (see
|
|
14084
|
+
* `packages/editor/src/entitlements`).
|
|
14085
|
+
*
|
|
14086
|
+
* `entitlements` is an open set of provider-defined strings; unknown values are
|
|
14087
|
+
* ignored rather than rejected.
|
|
14088
|
+
*/
|
|
14089
|
+
const entitlementsResultSchema = object({
|
|
14090
|
+
subscription: object({
|
|
14091
|
+
tier: string$1(),
|
|
14092
|
+
status: string$1()
|
|
14093
|
+
}).nullable(),
|
|
14094
|
+
entitlements: array(string$1())
|
|
14095
|
+
});
|
|
14096
|
+
/**
|
|
14097
|
+
* Which editor format a machine's stored definition is in: `digraph` is the
|
|
14098
|
+
* original (legacy) editor's format, `xgraph` the current one.
|
|
14099
|
+
*/
|
|
14100
|
+
const machineDefinitionFormatSchema = _enum(["digraph", "xgraph"]);
|
|
14101
|
+
/**
|
|
14102
|
+
* `name` and `updatedAt` are optional: some upstream project envelopes only
|
|
14103
|
+
* return machine ids. Providers that can supply them cheaply should.
|
|
14104
|
+
*/
|
|
14105
|
+
const projectMachineSummarySchema = object({
|
|
14106
|
+
machineId: string$1(),
|
|
14107
|
+
name: string$1().optional(),
|
|
14108
|
+
updatedAt: string$1().optional(),
|
|
14109
|
+
format: machineDefinitionFormatSchema.optional()
|
|
14110
|
+
});
|
|
14111
|
+
/**
|
|
14112
|
+
* A project list row. It carries the project's machine roster, not just its
|
|
14113
|
+
* metadata, so a client can mount a whole workspace from one `projects.list`
|
|
14114
|
+
* response and fetch definitions lazily.
|
|
14115
|
+
*/
|
|
14116
|
+
const projectSummarySchema = object({
|
|
14117
|
+
projectId: string$1(),
|
|
14118
|
+
projectVersionId: string$1(),
|
|
14119
|
+
name: string$1(),
|
|
14120
|
+
description: string$1().nullable(),
|
|
14121
|
+
visibility: projectVisibilitySchema,
|
|
14122
|
+
createdAt: string$1(),
|
|
14123
|
+
updatedAt: string$1(),
|
|
14124
|
+
rootMachineId: string$1().nullable().optional(),
|
|
14125
|
+
machines: array(projectMachineSummarySchema).optional(),
|
|
14126
|
+
permissions: object({ canEdit: boolean$1() }).optional(),
|
|
14127
|
+
allowedVisibility: array(projectVisibilitySchema).optional()
|
|
14128
|
+
});
|
|
14129
|
+
const projectSchema = projectSummarySchema.extend({
|
|
14130
|
+
rootMachineId: string$1().nullable(),
|
|
14131
|
+
machines: array(projectMachineSummarySchema),
|
|
14132
|
+
permissions: object({ canEdit: boolean$1() })
|
|
14133
|
+
});
|
|
14134
|
+
const machineSchema = object({
|
|
14135
|
+
machineId: string$1(),
|
|
14136
|
+
name: string$1(),
|
|
14137
|
+
projectId: string$1().optional(),
|
|
14138
|
+
projectVersionId: string$1(),
|
|
14139
|
+
definition: unknown(),
|
|
14140
|
+
graph: xgraphSchema.optional(),
|
|
14141
|
+
createdAt: string$1().optional(),
|
|
14142
|
+
updatedAt: string$1().optional(),
|
|
14143
|
+
format: machineDefinitionFormatSchema.optional()
|
|
14144
|
+
});
|
|
14145
|
+
const machineVersionSchema = object({
|
|
14146
|
+
machineVersionId: string$1(),
|
|
14147
|
+
machineId: string$1(),
|
|
14148
|
+
versionNumber: number$1(),
|
|
14149
|
+
name: string$1(),
|
|
14150
|
+
definition: unknown(),
|
|
14151
|
+
createdAt: string$1(),
|
|
14152
|
+
updatedAt: string$1(),
|
|
14153
|
+
format: machineDefinitionFormatSchema.optional()
|
|
14154
|
+
});
|
|
14155
|
+
/** Version-history row without the definition payload. */
|
|
14156
|
+
const machineVersionSummarySchema = object({
|
|
14157
|
+
machineVersionId: string$1(),
|
|
14158
|
+
machineId: string$1(),
|
|
14159
|
+
versionNumber: number$1(),
|
|
14160
|
+
name: string$1().nullable(),
|
|
14161
|
+
status: string$1(),
|
|
14162
|
+
parentVersionId: string$1().nullable(),
|
|
14163
|
+
createdAt: string$1(),
|
|
14164
|
+
updatedAt: string$1(),
|
|
14165
|
+
format: machineDefinitionFormatSchema.optional()
|
|
14166
|
+
});
|
|
14167
|
+
/** Result of converting a machine's stored definition to XGraph in place. */
|
|
14168
|
+
const machinesConvertResultSchema = object({
|
|
14169
|
+
machine: machineSchema,
|
|
14170
|
+
created: boolean$1(),
|
|
14171
|
+
version: object({
|
|
14172
|
+
machineVersionId: string$1(),
|
|
14173
|
+
versionNumber: number$1(),
|
|
14174
|
+
name: string$1().nullable()
|
|
14175
|
+
})
|
|
14176
|
+
});
|
|
14177
|
+
/**
|
|
14178
|
+
* A project the caller may fork a machine into, with the version ids a fork
|
|
14179
|
+
* can target. `projectVersionIds` is ordered as the provider reports it.
|
|
14180
|
+
*/
|
|
14181
|
+
const projectDestinationProjectSchema = object({
|
|
14182
|
+
projectId: string$1(),
|
|
14183
|
+
name: string$1(),
|
|
14184
|
+
visibility: projectVisibilitySchema,
|
|
14185
|
+
projectVersionIds: array(string$1())
|
|
14186
|
+
});
|
|
14187
|
+
/**
|
|
14188
|
+
* Fork destinations grouped by owner. The caller's personal projects are one
|
|
14189
|
+
* owner alongside each team; `ownerId` is opaque and provider-defined.
|
|
14190
|
+
*/
|
|
14191
|
+
const projectDestinationSchema = object({
|
|
14192
|
+
ownerId: string$1(),
|
|
14193
|
+
name: string$1(),
|
|
14194
|
+
projects: array(projectDestinationProjectSchema)
|
|
14195
|
+
});
|
|
14196
|
+
/** Result of forking a machine into a new or existing project version. */
|
|
14197
|
+
const machinesForkResultSchema = object({
|
|
14198
|
+
machine: machineSchema,
|
|
14199
|
+
projectVersionId: string$1(),
|
|
14200
|
+
projectId: string$1()
|
|
14201
|
+
});
|
|
14202
|
+
/**
|
|
14203
|
+
* The version holding a machine's pre-conversion (legacy editor) definition.
|
|
14204
|
+
* `versionId` is `null` when the machine has no such version, which is the
|
|
14205
|
+
* signal that the legacy editor cannot be re-entered for it.
|
|
14206
|
+
*/
|
|
14207
|
+
const machineLegacyVersionSchema = object({ versionId: string$1().nullable() });
|
|
14208
|
+
/** Result of restoring a machine's legacy-editor definition. */
|
|
14209
|
+
const machinesRestoreLegacyResultSchema = object({
|
|
14210
|
+
machine: machineSchema,
|
|
14211
|
+
version: object({
|
|
14212
|
+
machineVersionId: string$1(),
|
|
14213
|
+
versionNumber: number$1(),
|
|
14214
|
+
name: string$1().nullable()
|
|
14215
|
+
})
|
|
14216
|
+
});
|
|
14217
|
+
/**
|
|
14218
|
+
* Result of restoring a machine to one of its own versions.
|
|
14219
|
+
*
|
|
14220
|
+
* `capturedVersion` is the new version holding the machine's *pre-restore*
|
|
14221
|
+
* definition, so the restore itself is undoable. It is `null` when the restore
|
|
14222
|
+
* was a no-op (the machine already held that version's definition), which is
|
|
14223
|
+
* the signal that no history row was added.
|
|
14224
|
+
*/
|
|
14225
|
+
const machinesRestoreVersionResultSchema = object({
|
|
14226
|
+
machine: machineSchema,
|
|
14227
|
+
capturedVersion: machineVersionSummarySchema.nullable()
|
|
14228
|
+
});
|
|
14229
|
+
const extractedMachinesSchema = object({ machines: array(object({
|
|
14230
|
+
config: record(string$1(), unknown()),
|
|
14231
|
+
machineIndex: number$1().int().nonnegative().optional()
|
|
14232
|
+
})) });
|
|
14233
|
+
const projectsCreateRequestSchema = object({
|
|
14234
|
+
name: string$1().min(1),
|
|
14235
|
+
visibility: projectVisibilitySchema
|
|
14236
|
+
});
|
|
14237
|
+
const projectsUpdateRequestSchema = object({
|
|
14238
|
+
name: string$1().min(1).optional(),
|
|
14239
|
+
description: string$1().nullable().optional(),
|
|
14240
|
+
visibility: projectVisibilitySchema.optional()
|
|
14241
|
+
}).refine((value) => value.name !== void 0 || value.description !== void 0 || value.visibility !== void 0, { message: "At least one of `name`, `description` or `visibility` is required." });
|
|
14242
|
+
const machinesCreateRequestSchema = object({
|
|
14243
|
+
projectVersionId: string$1().min(1),
|
|
14244
|
+
xstateVersion: xstateVersionSchema,
|
|
14245
|
+
name: string$1().min(1).optional(),
|
|
14246
|
+
definition: unknown().optional()
|
|
14247
|
+
});
|
|
14248
|
+
const machinesUpdateRequestSchema = object({
|
|
14249
|
+
name: string$1().min(1).optional(),
|
|
14250
|
+
definition: unknown().optional()
|
|
14251
|
+
}).refine((value) => value.name !== void 0 || value.definition !== void 0, { message: "At least one of `name` or `definition` is required." });
|
|
14252
|
+
/**
|
|
14253
|
+
* `status` is canonical lowercase; providers map it to their own casing.
|
|
14254
|
+
* Omitting `definition` snapshots the machine's current definition.
|
|
14255
|
+
*/
|
|
14256
|
+
const machineVersionsCreateRequestSchema = object({
|
|
14257
|
+
name: string$1().min(1).optional(),
|
|
14258
|
+
definition: unknown().optional(),
|
|
14259
|
+
status: _enum(["committed", "auto"]).optional(),
|
|
14260
|
+
parentVersionId: string$1().min(1).optional()
|
|
14261
|
+
});
|
|
14262
|
+
const machinesConvertRequestSchema = object({
|
|
14263
|
+
definition: xgraphSchema,
|
|
14264
|
+
expectedUpdatedAt: string$1().min(1),
|
|
14265
|
+
keepOriginalVersion: boolean$1().optional()
|
|
14266
|
+
});
|
|
14267
|
+
/**
|
|
14268
|
+
* Fork a machine into exactly one target: an existing project version, or a
|
|
14269
|
+
* new project to create for it. Both, or neither, is a client bug.
|
|
14270
|
+
*/
|
|
14271
|
+
const machinesForkRequestSchema = object({
|
|
14272
|
+
targetProjectVersionId: string$1().min(1).optional(),
|
|
14273
|
+
targetProject: object({
|
|
14274
|
+
name: string$1().min(1),
|
|
14275
|
+
visibility: projectVisibilitySchema,
|
|
14276
|
+
teamId: string$1().min(1).optional()
|
|
14277
|
+
}).optional(),
|
|
14278
|
+
machineName: string$1().min(1).optional(),
|
|
14279
|
+
xstateVersion: xstateVersionSchema.optional()
|
|
14280
|
+
}).refine((value) => value.targetProjectVersionId === void 0 !== (value.targetProject === void 0), { message: "Exactly one of `targetProjectVersionId` or `targetProject` is required." });
|
|
14281
|
+
const machinesRestoreLegacyRequestSchema = object({
|
|
14282
|
+
versionId: string$1().min(1).optional(),
|
|
14283
|
+
expectedUpdatedAt: string$1().min(1),
|
|
14284
|
+
reason: string$1().optional()
|
|
14285
|
+
});
|
|
14286
|
+
const machinesRestoreVersionRequestSchema = object({ expectedUpdatedAt: string$1().min(1).optional() });
|
|
14287
|
+
const codeExtractMachinesRequestSchema = object({
|
|
14288
|
+
code: string$1().min(1),
|
|
14289
|
+
xstateVersion: xstateVersionSchema.optional()
|
|
14290
|
+
});
|
|
14291
|
+
const authVerifyResponseSchema = verifyResultSchema;
|
|
14292
|
+
const projectsListResponseSchema = array(projectSummarySchema);
|
|
14293
|
+
const projectsGetResponseSchema = projectSchema;
|
|
14294
|
+
const projectsCreateResponseSchema = projectSchema;
|
|
14295
|
+
const projectsUpdateResponseSchema = projectSchema;
|
|
14296
|
+
const projectsDeleteResponseSchema = object({ projectId: string$1() });
|
|
14297
|
+
const projectsListMachinesResponseSchema = array(projectMachineSummarySchema);
|
|
14298
|
+
const projectsDestinationsResponseSchema = array(projectDestinationSchema);
|
|
14299
|
+
const machinesCreateResponseSchema = machineSchema;
|
|
14300
|
+
const machinesGetResponseSchema = machineSchema;
|
|
14301
|
+
const machinesUpdateResponseSchema = machineSchema;
|
|
14302
|
+
const machinesGetVersionResponseSchema = machineVersionSchema;
|
|
14303
|
+
const machineVersionsListResponseSchema = array(machineVersionSummarySchema);
|
|
14304
|
+
const machineVersionsCreateResponseSchema = machineVersionSchema;
|
|
14305
|
+
const machinesConvertDefinitionResponseSchema = machinesConvertResultSchema;
|
|
14306
|
+
const machinesForkResponseSchema = machinesForkResultSchema;
|
|
14307
|
+
const machinesGetLegacyVersionResponseSchema = machineLegacyVersionSchema;
|
|
14308
|
+
const machinesRestoreLegacyResponseSchema = machinesRestoreLegacyResultSchema;
|
|
14309
|
+
const machinesRestoreVersionResponseSchema = machinesRestoreVersionResultSchema;
|
|
14310
|
+
const codeExtractMachinesResponseSchema = extractedMachinesSchema;
|
|
14311
|
+
/**
|
|
14312
|
+
* Request/response schema pairs keyed by resource capability name. Kept here
|
|
14313
|
+
* rather than on the `Capability` metadata entries so that the capability
|
|
14314
|
+
* registry stays plain, serialisable data.
|
|
14315
|
+
*/
|
|
14316
|
+
const resourceOperationSchemas = {
|
|
14317
|
+
"auth.verify": { response: authVerifyResponseSchema },
|
|
14318
|
+
"projects.list": { response: projectsListResponseSchema },
|
|
14319
|
+
"projects.create": {
|
|
14320
|
+
request: projectsCreateRequestSchema,
|
|
14321
|
+
response: projectsCreateResponseSchema
|
|
14322
|
+
},
|
|
14323
|
+
"projects.get": { response: projectsGetResponseSchema },
|
|
14324
|
+
"projects.update": {
|
|
14325
|
+
request: projectsUpdateRequestSchema,
|
|
14326
|
+
response: projectsUpdateResponseSchema
|
|
14327
|
+
},
|
|
14328
|
+
"projects.delete": { response: projectsDeleteResponseSchema },
|
|
14329
|
+
"projects.listMachines": { response: projectsListMachinesResponseSchema },
|
|
14330
|
+
"projects.destinations": { response: projectsDestinationsResponseSchema },
|
|
14331
|
+
"machines.create": {
|
|
14332
|
+
request: machinesCreateRequestSchema,
|
|
14333
|
+
response: machinesCreateResponseSchema
|
|
14334
|
+
},
|
|
14335
|
+
"machines.get": { response: machinesGetResponseSchema },
|
|
14336
|
+
"machines.getVersion": { response: machinesGetVersionResponseSchema },
|
|
14337
|
+
"machines.update": {
|
|
14338
|
+
request: machinesUpdateRequestSchema,
|
|
14339
|
+
response: machinesUpdateResponseSchema
|
|
14340
|
+
},
|
|
14341
|
+
"machines.versions.list": { response: machineVersionsListResponseSchema },
|
|
14342
|
+
"machines.versions.create": {
|
|
14343
|
+
request: machineVersionsCreateRequestSchema,
|
|
14344
|
+
response: machineVersionsCreateResponseSchema
|
|
14345
|
+
},
|
|
14346
|
+
"machines.convertDefinition": {
|
|
14347
|
+
request: machinesConvertRequestSchema,
|
|
14348
|
+
response: machinesConvertDefinitionResponseSchema
|
|
14349
|
+
},
|
|
14350
|
+
"machines.fork": {
|
|
14351
|
+
request: machinesForkRequestSchema,
|
|
14352
|
+
response: machinesForkResponseSchema
|
|
14353
|
+
},
|
|
14354
|
+
"machines.getLegacyVersion": { response: machinesGetLegacyVersionResponseSchema },
|
|
14355
|
+
"machines.restoreLegacy": {
|
|
14356
|
+
request: machinesRestoreLegacyRequestSchema,
|
|
14357
|
+
response: machinesRestoreLegacyResponseSchema
|
|
14358
|
+
},
|
|
14359
|
+
"machines.restoreVersion": {
|
|
14360
|
+
request: machinesRestoreVersionRequestSchema,
|
|
14361
|
+
response: machinesRestoreVersionResponseSchema
|
|
14362
|
+
}
|
|
14363
|
+
};
|
|
14364
|
+
/** Provider-independent operations implemented by this repository. */
|
|
14365
|
+
const codeOperationSchemas = { "code.extractMachines": {
|
|
14366
|
+
request: codeExtractMachinesRequestSchema,
|
|
14367
|
+
response: codeExtractMachinesResponseSchema
|
|
14368
|
+
} };
|
|
14369
|
+
/** Every owned API operation with a canonical request/response contract. */
|
|
14370
|
+
const operationSchemas = {
|
|
14371
|
+
...resourceOperationSchemas,
|
|
14372
|
+
...codeOperationSchemas
|
|
14373
|
+
};
|
|
14374
|
+
|
|
14375
|
+
//#endregion
|
|
14376
|
+
//#region src/studio.ts
|
|
14377
|
+
/**
|
|
14378
|
+
* Remote client for the owned Stately resource contract (`/api/v1/*`).
|
|
14379
|
+
*
|
|
14380
|
+
* Every method targets our own routes (never the legacy Registry API), sends
|
|
14381
|
+
* JSON bodies with a bearer credential, and validates responses against the
|
|
14382
|
+
* canonical Zod schemas from `@statelyai/api-contract`. Responses are canonical
|
|
14383
|
+
* values directly: there is no `{ data }` envelope. Errors use the nested
|
|
14384
|
+
* envelope `{ error: { code, message, issues?, retryable? } }`.
|
|
14385
|
+
*/
|
|
14386
|
+
/** Default base URL of the editor/API deployment hosting `/api/v1`. */
|
|
14387
|
+
const DEFAULT_STATELY_BASE_URL = "https://editor.stately.ai";
|
|
14388
|
+
var StudioApiError = class extends Error {
|
|
14389
|
+
status;
|
|
14390
|
+
/** Canonical resource error code, when the server sent one. */
|
|
14391
|
+
code;
|
|
14392
|
+
issues;
|
|
14393
|
+
retryable;
|
|
14394
|
+
constructor(message, status, options = {}) {
|
|
14395
|
+
super(message);
|
|
14396
|
+
this.name = "StudioApiError";
|
|
14397
|
+
this.status = status;
|
|
14398
|
+
this.code = options.code;
|
|
14399
|
+
this.issues = options.issues;
|
|
14400
|
+
this.retryable = options.retryable;
|
|
14401
|
+
}
|
|
14402
|
+
};
|
|
14403
|
+
function getFetch(fetchImpl) {
|
|
14404
|
+
const resolvedFetch = fetchImpl ?? globalThis.fetch;
|
|
14405
|
+
if (!resolvedFetch) throw new Error("No fetch implementation available. Pass one via createStatelyClient({ fetch }).");
|
|
14406
|
+
return resolvedFetch;
|
|
14407
|
+
}
|
|
14408
|
+
function joinApiUrl(baseUrl, path) {
|
|
14409
|
+
return `${baseUrl.replace(/\/+$/, "")}/api/v1${path}`;
|
|
14410
|
+
}
|
|
14411
|
+
async function parseJson(response) {
|
|
14412
|
+
if (!response.headers.get("content-type")?.includes("application/json")) return null;
|
|
14413
|
+
return response.json().catch(() => null);
|
|
14414
|
+
}
|
|
14415
|
+
function toApiError(data, status) {
|
|
14416
|
+
const parsed = resourceApiErrorResponseSchema.safeParse(data);
|
|
14417
|
+
if (parsed.success) {
|
|
14418
|
+
const { code, message, issues, retryable } = parsed.data.error;
|
|
14419
|
+
return new StudioApiError(message, status, {
|
|
14420
|
+
code,
|
|
14421
|
+
issues,
|
|
14422
|
+
retryable
|
|
14423
|
+
});
|
|
14424
|
+
}
|
|
14425
|
+
if (typeof data === "object" && data !== null && "error" in data && typeof data.error === "string") return new StudioApiError(data.error, status);
|
|
14426
|
+
return new StudioApiError(`HTTP ${status}`, status);
|
|
14427
|
+
}
|
|
14428
|
+
function normalizeVisibility(visibility) {
|
|
14429
|
+
return visibility.toLowerCase();
|
|
14430
|
+
}
|
|
14431
|
+
function normalizeXStateVersion(xstateVersion) {
|
|
14432
|
+
return xstateVersion === void 0 || xstateVersion === 4 ? 5 : xstateVersion;
|
|
14433
|
+
}
|
|
14434
|
+
function normalizeExtractXStateVersion(xstateVersion) {
|
|
14435
|
+
return xstateVersion === 4 ? 5 : xstateVersion;
|
|
14436
|
+
}
|
|
14437
|
+
function withMachineAlias(machine) {
|
|
14438
|
+
return {
|
|
14439
|
+
...machine,
|
|
14440
|
+
definition: machine.definition,
|
|
14441
|
+
id: machine.machineId
|
|
14442
|
+
};
|
|
14443
|
+
}
|
|
14444
|
+
function withProjectAlias(project) {
|
|
14445
|
+
return {
|
|
14446
|
+
...project,
|
|
14447
|
+
id: project.projectVersionId
|
|
14448
|
+
};
|
|
14449
|
+
}
|
|
14450
|
+
function isCredentialLike(value) {
|
|
14451
|
+
if (typeof value === "string") return true;
|
|
14452
|
+
return typeof value === "object" && value !== null && "type" in value && (value.type === "api_key" || value.type === "oauth");
|
|
14453
|
+
}
|
|
14454
|
+
function createStatelyClient(options = {}) {
|
|
14455
|
+
const baseUrl = options.baseUrl ?? DEFAULT_STATELY_BASE_URL;
|
|
14456
|
+
const fetchImpl = getFetch(options.fetch);
|
|
14457
|
+
const defaultCredential = options.credential ?? (options.apiKey ? {
|
|
14458
|
+
type: "api_key",
|
|
14459
|
+
token: options.apiKey
|
|
14460
|
+
} : void 0);
|
|
14461
|
+
const defaultAuthMode = options.authMode ?? "auto";
|
|
14462
|
+
async function request(path, init, schema, requestOptions = {}) {
|
|
14463
|
+
const headers = new Headers(init.headers);
|
|
14464
|
+
const authMode = requestOptions.authMode ?? defaultAuthMode;
|
|
14465
|
+
const credential = requestOptions.credential ?? defaultCredential;
|
|
14466
|
+
if (authMode !== "none") {
|
|
14467
|
+
const token = getCredentialToken(credential);
|
|
14468
|
+
if (authMode === "bearer" && (!token || !credential)) throw new StudioApiError("No Stately credential configured. Pass createStatelyClient({ credential }) or use authMode: \"auto\" to let the server decide whether authentication is required.", 401, { code: "unauthenticated" });
|
|
14469
|
+
if (token && credential) headers.set("Authorization", createAuthorizationHeader(credential));
|
|
14470
|
+
}
|
|
14471
|
+
const response = await fetchImpl(joinApiUrl(baseUrl, path), {
|
|
14472
|
+
...init,
|
|
14473
|
+
headers,
|
|
14474
|
+
...requestOptions.signal ? { signal: requestOptions.signal } : {}
|
|
14475
|
+
});
|
|
14476
|
+
const data = await parseJson(response);
|
|
14477
|
+
if (!response.ok) throw toApiError(data, response.status);
|
|
14478
|
+
const parsed = schema.safeParse(data);
|
|
14479
|
+
if (!parsed.success) throw new StudioApiError(`Unexpected response for ${path}: ${parsed.error.message}`, response.status, {
|
|
14480
|
+
code: "internal_error",
|
|
14481
|
+
issues: [...parsed.error.issues]
|
|
14482
|
+
});
|
|
14483
|
+
return parsed.data;
|
|
14484
|
+
}
|
|
14485
|
+
function jsonInit(method, body) {
|
|
14486
|
+
return {
|
|
14487
|
+
method,
|
|
14488
|
+
headers: { "Content-Type": "application/json" },
|
|
14489
|
+
body: JSON.stringify(body)
|
|
14490
|
+
};
|
|
14491
|
+
}
|
|
14492
|
+
const projects = {
|
|
14493
|
+
list(requestOptions) {
|
|
14494
|
+
return request("/projects", { method: "GET" }, projectsListResponseSchema, requestOptions);
|
|
14495
|
+
},
|
|
14496
|
+
create(input, requestOptions) {
|
|
14497
|
+
return request("/projects", jsonInit("POST", {
|
|
14498
|
+
name: input.name,
|
|
14499
|
+
visibility: normalizeVisibility(input.visibility)
|
|
14500
|
+
}), projectSchema, requestOptions).then(withProjectAlias);
|
|
14501
|
+
},
|
|
14502
|
+
get(projectId, requestOptions) {
|
|
14503
|
+
return request(`/projects/${encodeURIComponent(projectId)}`, { method: "GET" }, projectSchema, requestOptions).then(withProjectAlias);
|
|
14504
|
+
},
|
|
14505
|
+
update(projectId, input, requestOptions) {
|
|
14506
|
+
return request(`/projects/${encodeURIComponent(projectId)}`, jsonInit("PATCH", {
|
|
14507
|
+
...input.name !== void 0 ? { name: input.name } : {},
|
|
14508
|
+
...input.description !== void 0 ? { description: input.description } : {},
|
|
14509
|
+
...input.visibility !== void 0 ? { visibility: normalizeVisibility(input.visibility) } : {}
|
|
14510
|
+
}), projectSchema, requestOptions).then(withProjectAlias);
|
|
14511
|
+
},
|
|
14512
|
+
delete(projectId, requestOptions) {
|
|
14513
|
+
return request(`/projects/${encodeURIComponent(projectId)}`, { method: "DELETE" }, projectsDeleteResponseSchema, requestOptions);
|
|
14514
|
+
},
|
|
14515
|
+
listMachines(projectId, requestOptions) {
|
|
14516
|
+
return request(`/projects/${encodeURIComponent(projectId)}/machines`, { method: "GET" }, projectsListMachinesResponseSchema, requestOptions);
|
|
14517
|
+
},
|
|
14518
|
+
async ensure(input, requestOptions) {
|
|
14519
|
+
if (input.matchConnectedRepo !== false) {
|
|
14520
|
+
const match = (await projects.list(requestOptions)).find((candidate) => candidate.name === input.name);
|
|
14521
|
+
if (match) return projects.get(match.projectId, requestOptions);
|
|
14522
|
+
}
|
|
14523
|
+
return projects.create(input, requestOptions);
|
|
14524
|
+
}
|
|
14525
|
+
};
|
|
14526
|
+
const machines = {
|
|
14527
|
+
create(input, requestOptions) {
|
|
14528
|
+
return request("/machines", jsonInit("POST", {
|
|
14529
|
+
projectVersionId: input.projectVersionId,
|
|
14530
|
+
xstateVersion: normalizeXStateVersion(input.xstateVersion),
|
|
14531
|
+
...input.name !== void 0 ? { name: input.name } : {},
|
|
14532
|
+
...input.definition !== void 0 ? { definition: input.definition } : {}
|
|
14533
|
+
}), machineSchema, requestOptions).then((machine) => withMachineAlias(machine));
|
|
14534
|
+
},
|
|
14535
|
+
async createMany(input, requestOptions) {
|
|
14536
|
+
return [await machines.create(input, requestOptions)];
|
|
14537
|
+
},
|
|
14538
|
+
get(machineId, getOptions = {}) {
|
|
14539
|
+
return request(`/machines/${encodeURIComponent(machineId)}`, { method: "GET" }, machineSchema, getOptions).then((machine) => withMachineAlias(machine));
|
|
14540
|
+
},
|
|
14541
|
+
getVersion(machineId, versionId, requestOptions) {
|
|
14542
|
+
return request(`/machines/${encodeURIComponent(machineId)}/versions/${encodeURIComponent(versionId)}`, { method: "GET" }, machineVersionSchema, requestOptions);
|
|
14543
|
+
},
|
|
14544
|
+
update(machineIdOrInput, inputOrOptions, maybeOptions) {
|
|
14545
|
+
const machineId = typeof machineIdOrInput === "string" ? machineIdOrInput : machineIdOrInput.machineId ?? machineIdOrInput.id;
|
|
14546
|
+
if (!machineId) throw new StudioApiError("machines.update requires a machine id.", 400, { code: "bad_request" });
|
|
14547
|
+
const input = (typeof machineIdOrInput === "string" ? inputOrOptions : machineIdOrInput) ?? {};
|
|
14548
|
+
const requestOptions = typeof machineIdOrInput === "string" ? maybeOptions : inputOrOptions;
|
|
14549
|
+
return request(`/machines/${encodeURIComponent(machineId)}`, jsonInit("PATCH", {
|
|
14550
|
+
...input.name !== void 0 ? { name: input.name } : {},
|
|
14551
|
+
...input.definition !== void 0 ? { definition: input.definition } : {}
|
|
14552
|
+
}), machineSchema, requestOptions).then((machine) => withMachineAlias(machine));
|
|
14553
|
+
}
|
|
14554
|
+
};
|
|
14555
|
+
return {
|
|
14556
|
+
auth: { verify(credentialOrOptions, verifyOptions) {
|
|
14557
|
+
return request("/auth/verify", { method: "GET" }, verifyResultSchema, isCredentialLike(credentialOrOptions) ? {
|
|
14558
|
+
...verifyOptions,
|
|
14559
|
+
credential: credentialOrOptions
|
|
14560
|
+
} : credentialOrOptions ?? verifyOptions ?? {});
|
|
14561
|
+
} },
|
|
14562
|
+
projects,
|
|
14563
|
+
machines,
|
|
14564
|
+
code: { extractMachines(codeOrInput, extractOptions = {}) {
|
|
14565
|
+
const input = typeof codeOrInput === "string" ? {
|
|
14566
|
+
code: codeOrInput,
|
|
14567
|
+
xstateVersion: extractOptions.xstateVersion
|
|
14568
|
+
} : codeOrInput;
|
|
14569
|
+
const legacyOptions = extractOptions;
|
|
14570
|
+
const credential = legacyOptions.credential ?? (legacyOptions.apiKey ? {
|
|
14571
|
+
type: "api_key",
|
|
14572
|
+
token: legacyOptions.apiKey
|
|
14573
|
+
} : void 0);
|
|
14574
|
+
return request("/code/extract-machines", jsonInit("POST", {
|
|
14575
|
+
code: input.code,
|
|
14576
|
+
xstateVersion: normalizeExtractXStateVersion(input.xstateVersion)
|
|
14577
|
+
}), extractedMachinesSchema, {
|
|
14578
|
+
...extractOptions,
|
|
14579
|
+
credential
|
|
14580
|
+
});
|
|
14581
|
+
} }
|
|
14582
|
+
};
|
|
14583
|
+
}
|
|
14584
|
+
|
|
14585
|
+
//#endregion
|
|
14586
|
+
export { StudioApiError as n, createStatelyClient as r, DEFAULT_STATELY_BASE_URL as t };
|
package/dist/studio.d.mts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import { A as Machine, C as StudioMachineRecord, D as VerifyApiKeyResponse, E as UpdateProjectInput, F as ProjectVisibility, I as VerifyResult, L as XStateVersion, M as Project, N as ProjectMachineSummary, O as createStatelyClient, P as ProjectSummary, R as ResourceErrorCode, S as StudioClientOptions, T as UpdateMachineInput, _ as ProjectMachine, a as CreateMachineTemplate, b as StudioApiErrorOptions, c as EnsureProjectInput, d as ExtractedMachine, f as GetMachineOptions, g as ProjectData, h as LegacyUpdateMachineInput, i as CreateMachineInput, j as MachineVersion, k as ExtractedMachines, l as ExtractMachinesInput, m as LegacyProjectVisibility, n as CreateMachineFromDefinitionInput, o as CreateProjectInput, p as LegacyExtractMachinesOptions, r as CreateMachineFromTemplateInput, s as DEFAULT_STATELY_BASE_URL, t as ConnectedRepo, u as ExtractMachinesResponse, v as RepoType, w as StudioRequestOptions, x as StudioClient, y as StudioApiError } from "./studio-
|
|
1
|
+
import { A as Machine, C as StudioMachineRecord, D as VerifyApiKeyResponse, E as UpdateProjectInput, F as ProjectVisibility, I as VerifyResult, L as XStateVersion, M as Project, N as ProjectMachineSummary, O as createStatelyClient, P as ProjectSummary, R as ResourceErrorCode, S as StudioClientOptions, T as UpdateMachineInput, _ as ProjectMachine, a as CreateMachineTemplate, b as StudioApiErrorOptions, c as EnsureProjectInput, d as ExtractedMachine, f as GetMachineOptions, g as ProjectData, h as LegacyUpdateMachineInput, i as CreateMachineInput, j as MachineVersion, k as ExtractedMachines, l as ExtractMachinesInput, m as LegacyProjectVisibility, n as CreateMachineFromDefinitionInput, o as CreateProjectInput, p as LegacyExtractMachinesOptions, r as CreateMachineFromTemplateInput, s as DEFAULT_STATELY_BASE_URL, t as ConnectedRepo, u as ExtractMachinesResponse, v as RepoType, w as StudioRequestOptions, x as StudioClient, y as StudioApiError } from "./studio-3ujfe2z0.mjs";
|
|
2
2
|
export { ConnectedRepo, CreateMachineFromDefinitionInput, CreateMachineFromTemplateInput, CreateMachineInput, CreateMachineTemplate, CreateProjectInput, DEFAULT_STATELY_BASE_URL, EnsureProjectInput, ExtractMachinesInput, ExtractMachinesResponse, ExtractedMachine, ExtractedMachines, GetMachineOptions, LegacyExtractMachinesOptions, LegacyProjectVisibility, LegacyUpdateMachineInput, Machine, MachineVersion, Project, ProjectData, ProjectMachine, ProjectMachineSummary, ProjectSummary, ProjectVisibility, RepoType, ResourceErrorCode, StudioApiError, StudioApiErrorOptions, StudioClient, StudioClientOptions, StudioMachineRecord, StudioRequestOptions, UpdateMachineInput, UpdateProjectInput, VerifyApiKeyResponse, VerifyResult, XStateVersion, createStatelyClient };
|
package/dist/studio.mjs
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import "./
|
|
2
|
-
import
|
|
1
|
+
import { n as StudioApiError, r as createStatelyClient, t as DEFAULT_STATELY_BASE_URL } from "./studio-Bn3alVku.mjs";
|
|
2
|
+
import "./auth.mjs";
|
|
3
3
|
|
|
4
4
|
export { DEFAULT_STATELY_BASE_URL, StudioApiError, createStatelyClient };
|
|
@@ -378,7 +378,7 @@ function createWebSocketTransport(options) {
|
|
|
378
378
|
|
|
379
379
|
//#endregion
|
|
380
380
|
//#region src/version.ts
|
|
381
|
-
const SDK_VERSION = "0.
|
|
381
|
+
const SDK_VERSION = "0.35.0";
|
|
382
382
|
function inspectionRuntime() {
|
|
383
383
|
if (typeof window !== "undefined") return "browser";
|
|
384
384
|
if (typeof process !== "undefined" && process.versions?.node) return "node";
|