@onlyworlds/sdk 4.173.1 → 4.175.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/CHANGELOG.md +16 -0
- package/dist/index.d.ts +20 -6
- package/dist/index.js +21 -2
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,22 @@ earlier history lives in git log only.
|
|
|
5
5
|
|
|
6
6
|
## [Unreleased]
|
|
7
7
|
|
|
8
|
+
## [4.175.0] - 2026-11-16
|
|
9
|
+
|
|
10
|
+
### Added
|
|
11
|
+
|
|
12
|
+
- **`OwApiError.isHostBlocked`: a write the host refused before the API saw it.** The host in front of onlyworlds.com answers some writes with a 403 whose body is an HTML page titled "Blocked", not the API's JSON envelope: text that holds a shell command such as `python -m`, `python -c`, `perl -e`, or `curl` or `wget` with an address right after a backtick, a semicolon or a pipe. Such an error read "OnlyWorlds API error 403" until now. It now says the host refused the request and nothing was written, and how to write the command so it passes (a fenced code block whose first line names a language, or no backtick). `code` stays null, as it is no API code, and `detail` keeps the page. Read on the page's title and on the body not being JSON, so the API's own 403s read as before.
|
|
13
|
+
|
|
14
|
+
### Fixed
|
|
15
|
+
|
|
16
|
+
- **`removeSeat`'s description** says when the Character a seat plays goes with it: only while it is as the seat's join left it (made by the join, named as the seat, supertype `Agent` alone, last written by the join, linked from nothing and played by no one else). Any other stays, one given to the seat to play included.
|
|
17
|
+
|
|
18
|
+
## [4.174.0] - 2026-11-16
|
|
19
|
+
|
|
20
|
+
### Added
|
|
21
|
+
|
|
22
|
+
- **`BY_LINKS_3D_VERSION`: the version of `layoutByLinks3d`'s answers.** It starts at 1 and is raised exactly when the answer to some case of the method's fixture changes (a constant, a rule, or a fix that moves a point), never for a release that moves none. A tool that keeps a picture to hand back as `held` can store it beside the points and read a different value as no picture kept, so a change to the method lays the world out fresh instead of holding points the method no longer gives. A test pins every fixture case's answer by its sha256 under the version (`test/fixtures/layout/by-links-3d.answers.json`), and `scripts/pin-layout-answers.mjs` refuses to pin a moved answer unless the version has been raised. No point of the method moves.
|
|
23
|
+
|
|
8
24
|
## [4.173.1] - 2026-11-16
|
|
9
25
|
|
|
10
26
|
### Fixed
|
package/dist/index.d.ts
CHANGED
|
@@ -4245,6 +4245,14 @@ declare class OwApiError extends Error {
|
|
|
4245
4245
|
readonly retryAfter: number | null;
|
|
4246
4246
|
constructor(status: number, code: string | null, message: string, docUrl: string | null, detail: unknown, type?: string | null, param?: string | null, retryAfter?: number | null);
|
|
4247
4247
|
get isAuthError(): boolean;
|
|
4248
|
+
/**
|
|
4249
|
+
* The host in front of onlyworlds.com refused the request before the API saw it: a 403 whose body is an HTML
|
|
4250
|
+
* page titled "Blocked", not the API's JSON envelope. Nothing was written. The host refuses text that holds a
|
|
4251
|
+
* shell command such as `python -m`, `python -c`, `perl -e`, or `curl` or `wget` with an address right after
|
|
4252
|
+
* a backtick, a semicolon or a pipe; such a command passes in a fenced code block whose first line names a
|
|
4253
|
+
* language, or without the backtick. `code` is null (it is no API code) and `detail` keeps the page.
|
|
4254
|
+
*/
|
|
4255
|
+
get isHostBlocked(): boolean;
|
|
4248
4256
|
/** 422s/400s name the offending param/field -- typos error loudly platform-wide. */
|
|
4249
4257
|
get isValidationError(): boolean;
|
|
4250
4258
|
/**
|
|
@@ -4570,9 +4578,6 @@ declare class OwSignInError extends Error {
|
|
|
4570
4578
|
retryAfter?: number;
|
|
4571
4579
|
});
|
|
4572
4580
|
}
|
|
4573
|
-
/** Parse a wire envelope into OwApiError parts (exported for the error type-tests). */
|
|
4574
|
-
/** Parse the platform ERROR envelope into an OwApiError. (Renamed from parseEnvelope in 4.0 —
|
|
4575
|
-
* distinct from the world-export envelope, which is a different artifact entirely.) */
|
|
4576
4581
|
declare function parseErrorEnvelope(status: number, body: unknown, retryAfter?: number | null): OwApiError;
|
|
4577
4582
|
/** Build an OwApiError from a non-2xx response, tolerating non-JSON bodies. */
|
|
4578
4583
|
declare function errorFromResponse(res: Response): Promise<OwApiError>;
|
|
@@ -5397,8 +5402,10 @@ declare class OwV2Client {
|
|
|
5397
5402
|
rekeySeat(worldId: string, seatId: string): Promise<OwSeatCreated>;
|
|
5398
5403
|
/**
|
|
5399
5404
|
* DELETE /account/worlds/{worldId}/seats/{seatId} -- remove an agent seat: its sponsor or the
|
|
5400
|
-
* world's owner may. Its key and secret stop at once;
|
|
5401
|
-
*
|
|
5405
|
+
* world's owner may. Its key and secret stop at once; the Character it plays goes with it only
|
|
5406
|
+
* while it is as the join left one (made by the join, named as the seat, supertype `Agent` alone,
|
|
5407
|
+
* last written by the join, linked from nothing, played by no one else); any other stays, one
|
|
5408
|
+
* given to the seat to play included. Needs the client's `ow_a_` token.
|
|
5402
5409
|
*/
|
|
5403
5410
|
removeSeat(worldId: string, seatId: string): Promise<void>;
|
|
5404
5411
|
/**
|
|
@@ -6817,6 +6824,13 @@ declare function unplacedAround(graph: OwLayoutGraph, focus: string, placed: Ite
|
|
|
6817
6824
|
|
|
6818
6825
|
/** The rest length of the by-links-3d layout: a link's length at rest, and the unit of its answer's points. */
|
|
6819
6826
|
declare const BY_LINKS_3D_REST = 60;
|
|
6827
|
+
/**
|
|
6828
|
+
* The version of `layoutByLinks3d`'s answers: raised whenever the answer to any case of the method's fixture
|
|
6829
|
+
* changes (a constant, a rule, a fix that moves a point), and never for a release that moves none. A tool that keeps
|
|
6830
|
+
* a picture to hand back as `held` stores it beside the points and reads another value as no picture kept, so a
|
|
6831
|
+
* change to the method lays the world out fresh instead of holding points the method no longer gives.
|
|
6832
|
+
*/
|
|
6833
|
+
declare const BY_LINKS_3D_VERSION = 1;
|
|
6820
6834
|
/** `layoutByLinks3d`'s options. */
|
|
6821
6835
|
interface OwLayoutByLinks3dOptions {
|
|
6822
6836
|
/**
|
|
@@ -8252,4 +8266,4 @@ declare class TokenResource {
|
|
|
8252
8266
|
getEncryptionInfo(): Promise<EncryptionInfo>;
|
|
8253
8267
|
}
|
|
8254
8268
|
|
|
8255
|
-
export { AGENT_DOORS, ASK_LIMITS, type AccessKeyResponse, BY_LINKS_3D_REST, CALENDAR_FIELD, CALENDAR_SUPERTYPE, CHARTER_PAIRS, type CalendarConfig, type CalendarEra, type CalendarIntercalary, type CalendarMonths, type CalendarWeek, DATE_FIELD, DECLARED_LINKS, ELEMENT_FAMILIES, ELEMENT_GROUPS, ELEMENT_ICONS, ELEMENT_LABELS, ELEMENT_SECTIONS, ELEMENT_TYPES, type ElementFamily, type ElementGroup, type ElementType, type EncryptionInfo, type EraDomain, FAMILY_COLORS, FAMILY_ORDER, FIELD_ACRONYMS, FIELD_SCHEMA, FILE_EXTENSIONS, type FieldInfo, type FieldType, GROUP_COLORS, GROUP_ORDER, GameTier, type ListParams, MESSAGE_PAIR, NOTE_PAIR, ONLYWORLDS_VERSION, type OwAccountToken, type OwAccountWorld, type OwAddress, type OwAddressAt, OwAddressError, type OwAddressForm, type OwAddressFound, type OwAddressReading, type OwAddressReason, type OwAddressingOptions, type OwAgentJoined, type OwAiAskAnswer, type OwAiAskBody, type OwAiMeter, type OwAiRefusal, type OwAiSortAnswer, type OwAiSortBody, type OwAiToken, type OwAiUse, type OwAllowance, OwApiError, type OwAskAnswer, type OwAskContext, type OwAskContextOptions, type OwAskLeftOut, type OwAuthErrorCode, type OwBulkItem, type OwBulkItemResult, type OwBulkResponse, type OwCalendarElement, type OwChange, type OwChangeDelete, type OwChangeUpsert, type OwChangesPage, type OwCharterWorld, type OwClientConfig, type OwCreateAccountWorldInput, type OwCreatedAccountWorld, type OwCreatedWorldLink, type OwDeleteReason, type OwDoor, type OwDragField, type OwDraught, type OwDraughtCompact, type OwDraughtComponent, type OwDraughtItem, type OwDraughtLens, type OwDraughtPolicy, type OwEdited, type OwElement, type OwElementBase, type OwElementMark, type OwErrorBody, type OwFileAddedBy, type OwFileDownload, type OwFileKind, type OwFileRow, type OwFileTicket, type OwFrontDoor, type OwGraphCutReason, type OwGraphEdge, type OwGraphMark, type OwGraphNode, type OwGraphOptions, type OwHiddenRow, type OwInstant, type OwJoinPreview, type OwJoined, type OwJoinedMembership, type OwKeyKind, type OwLanding, type OwLandingCluster, type OwLandingGap, type OwLandingGapKind, type OwLandingMember, type OwLandingMode, type OwLandingOptions, type OwLayout3dHow, type OwLayout3dPart, type OwLayoutAround, type OwLayoutAroundOptions, type OwLayoutAroundPoint, type OwLayoutByKind, type OwLayoutByLinks3d, type OwLayoutByLinks3dOptions, type OwLayoutGraph, type OwLayoutOf, type OwLayoutPoint, type OwLensCutReason, type OwLensMail, type OwLensOptions, type OwLensReader, type OwLensReading, type OwLensWorld, type OwLinkEdit, type OwLookupElement, type OwLookupHit, type OwLookupLink, type OwLookupOptions, type OwLookupReason, type OwMapSpace, type OwMapSpaceMap, type OwMapSpaceOutReason, type OwMapSpaceOutline, type OwMapSpacePin, type OwMapSpacePoint, type OwMe, type OwMediaTicket, type OwMember, type OwMemberLenses, type OwMemberRole, type OwMessageMember, type OwMintedAiToken, type OwMintedKey, type OwMySeat, type OwNamesMap, OwNetworkError, type OwOpener, type OwOpenerKind, type OwOpenerState, type OwOpenerSurface, type OwOpenersOptions, type OwPage, type OwPaidBy, type OwPhotoOptions, type OwPhotoPlan, type OwPlayerJoined, OwPreconditionFailedError, type OwPreparedPhoto, type OwProposal, type OwProposalAccepted, type OwProposalConflict, type OwProposalList, type OwProposalQuery, type OwProposalState, type OwProposeInput, type OwProposed, OwProposedError, type OwProposedMark, type OwProposedNewElement, type OwReadWorldFile, type OwReadWorldFileOptions, type OwReadingAids, type OwReadingAidsCharter, type OwReadingAidsDomain, type OwReadingAidsGuide, type OwReadingAidsHub, type OwRecord, type OwRecordMark, type OwRecordStory, type OwRemovalTicket, type OwRemovedImage, type OwRenderOptions, type OwReportGroup, type OwReportLine, type OwReportLineOptions, type OwReportLint, type OwReportParentKind, type OwReportThreads, type OwResyncReason, type OwReviewInput, type OwReviewed, type OwSearchResult, type OwSearchResults, type OwSeat, type OwSeatCreated, type OwSender, type OwSenderStatus, type OwServedReadingAids, type OwSignInBegin, type OwSignInBegun, type OwSignInComplete, OwSignInError, type OwSignInReason, type OwSignInResult, type OwSignInStorage, type OwSignedIn, type OwSortAddToRow, type OwSortAnswer, type OwSortAskRow, type OwSortLinkRow, type OwSortMakeRow, type OwSortNote, type OwSortRef, type OwSortRow, OwStaleProposalError, type OwStrand, type OwStrandSlot, type OwStrandWorld, type OwTool, type OwToolNeeds, type OwToolOpen, type OwTrailGround, type OwTrailHanger, type OwTrailInput, type OwTrailLayout, type OwTrailPin, type OwTrailPlace, type OwTrailSettings, type OwTrailSpiral, type OwTrailTier, type OwUploadedFile, type OwUploadedImage, OwV2Client, type OwView, type OwViewRow, type OwViewsTable, type OwWordPair, type OwWorldFileEntry, OwWorldFileError, type OwWorldFileReason, type OwWorldFileRow, type OwWorldFiles, type OwWorldGraph, type OwWorldIndex, type OwWorldKeyMember, type OwWorldKeyRow, type OwWorldLens, type OwWorldLensReading, type OwWorldLenses, type OwWorldLink, type OwWorldMeta, type OwWorldOrigin, type OwWorldProducer, type OwWorldProposalList, type OwWorldProposalQuery, type OwWorldProposalRow, type OwWorldPublicPage, type OwWorldSource, type OwWriteDoor, type OwWriteWorldFileOptions, type OwWriteWorldFileReport, PHOTO_MAX_BYTES, PHOTO_TYPES, PROPOSED_MARK, PUBLIC_FIELDS, type ParseError, type ParseOptions, type ParseResult, RECORD_FIELD, REVIEW_PROPOSED_LABEL, ROOM_PAIRS, type RevokeAllSessionsResponse, type RevokeSessionResponse, SPATIAL_TYPES, STRAND_FIELD, type SectionInfo, type StepBreakdown, TOOLS, TRAIL_TIERS, type TokenConsumeParams, type TokenConsumeResponse, TokenResource, type TokenStatus, type TokenTransport, VIEWS, WORLD_FILE_MAX_BYTES, WORLD_FILE_MAX_ENTRIES, WORLD_FILE_MEDIA_TYPE, type WorldCalendar, absYearForEraYear, absoluteYear, approxYearLength, base64url, breakdownStep, buildAskContext, buildWorldIndex, charterOf, compareInstants, dateOf, degreeOf, detectKeyKind, displayYear, domainsOf, doorWhere, doorsOf, dragField, draughtText, editedBy, elementAddress, elementColor, eraForStep, errorFromResponse, familyOf, fieldLabel, fileKindOf, findOwLinks, floorDiv, floorMod, formatDuration, formatMidLabel, formatStep, formatYearLabel, getElementIcon, getElementLabel, groupOf, handsOnAsProposed, hasUnseenRecipients, instantOf, intercalaryInYear, isAddressedTo, isAgentDoor, isCharterElement, isDemoKey, isKnownOf, isLeapYear, isLens, isMessage, isNote, isParseError, isRoomElement, isSentBy, isTemplate, isToEveryone, kindCanWrite, landingOf, layoutAround, layoutByKind, layoutByLinks3d, layoutOf, lensesInUse, lookupWorld, mapSpace, monthStartSteps, nfc, noteOf, openersFor, outDegreeOf, parseDate, parseErrorEnvelope, parseOwLink, pinExpectation, pkceChallenge, planPhoto, preparePhoto, proposedMarkOf, readCalendarConfig, readCalendarValue, readMarkOf, readOwLinkAt, readReportLine, readReportLines, readWorldFile, readingAidOf, recipientsOf, recordMarkOf, recordsOf, renderElement, reportThreadsOf, resolveCalendar, resolveCalendarLens, resolveEraDomains, resolveLens, roundHalfEven, senderStatus, simpleCaseFold, strandOf, threadOf, trailByPlace, typeWord, unplacedAround, unplacedByKind, unplacedByLinks3d, unreadFor, validateCalendarConfig, viewOf, weekdayForStep, worldCalendars, worldGraph, writeWorldFile, yearLength, yearStartStep };
|
|
8269
|
+
export { AGENT_DOORS, ASK_LIMITS, type AccessKeyResponse, BY_LINKS_3D_REST, BY_LINKS_3D_VERSION, CALENDAR_FIELD, CALENDAR_SUPERTYPE, CHARTER_PAIRS, type CalendarConfig, type CalendarEra, type CalendarIntercalary, type CalendarMonths, type CalendarWeek, DATE_FIELD, DECLARED_LINKS, ELEMENT_FAMILIES, ELEMENT_GROUPS, ELEMENT_ICONS, ELEMENT_LABELS, ELEMENT_SECTIONS, ELEMENT_TYPES, type ElementFamily, type ElementGroup, type ElementType, type EncryptionInfo, type EraDomain, FAMILY_COLORS, FAMILY_ORDER, FIELD_ACRONYMS, FIELD_SCHEMA, FILE_EXTENSIONS, type FieldInfo, type FieldType, GROUP_COLORS, GROUP_ORDER, GameTier, type ListParams, MESSAGE_PAIR, NOTE_PAIR, ONLYWORLDS_VERSION, type OwAccountToken, type OwAccountWorld, type OwAddress, type OwAddressAt, OwAddressError, type OwAddressForm, type OwAddressFound, type OwAddressReading, type OwAddressReason, type OwAddressingOptions, type OwAgentJoined, type OwAiAskAnswer, type OwAiAskBody, type OwAiMeter, type OwAiRefusal, type OwAiSortAnswer, type OwAiSortBody, type OwAiToken, type OwAiUse, type OwAllowance, OwApiError, type OwAskAnswer, type OwAskContext, type OwAskContextOptions, type OwAskLeftOut, type OwAuthErrorCode, type OwBulkItem, type OwBulkItemResult, type OwBulkResponse, type OwCalendarElement, type OwChange, type OwChangeDelete, type OwChangeUpsert, type OwChangesPage, type OwCharterWorld, type OwClientConfig, type OwCreateAccountWorldInput, type OwCreatedAccountWorld, type OwCreatedWorldLink, type OwDeleteReason, type OwDoor, type OwDragField, type OwDraught, type OwDraughtCompact, type OwDraughtComponent, type OwDraughtItem, type OwDraughtLens, type OwDraughtPolicy, type OwEdited, type OwElement, type OwElementBase, type OwElementMark, type OwErrorBody, type OwFileAddedBy, type OwFileDownload, type OwFileKind, type OwFileRow, type OwFileTicket, type OwFrontDoor, type OwGraphCutReason, type OwGraphEdge, type OwGraphMark, type OwGraphNode, type OwGraphOptions, type OwHiddenRow, type OwInstant, type OwJoinPreview, type OwJoined, type OwJoinedMembership, type OwKeyKind, type OwLanding, type OwLandingCluster, type OwLandingGap, type OwLandingGapKind, type OwLandingMember, type OwLandingMode, type OwLandingOptions, type OwLayout3dHow, type OwLayout3dPart, type OwLayoutAround, type OwLayoutAroundOptions, type OwLayoutAroundPoint, type OwLayoutByKind, type OwLayoutByLinks3d, type OwLayoutByLinks3dOptions, type OwLayoutGraph, type OwLayoutOf, type OwLayoutPoint, type OwLensCutReason, type OwLensMail, type OwLensOptions, type OwLensReader, type OwLensReading, type OwLensWorld, type OwLinkEdit, type OwLookupElement, type OwLookupHit, type OwLookupLink, type OwLookupOptions, type OwLookupReason, type OwMapSpace, type OwMapSpaceMap, type OwMapSpaceOutReason, type OwMapSpaceOutline, type OwMapSpacePin, type OwMapSpacePoint, type OwMe, type OwMediaTicket, type OwMember, type OwMemberLenses, type OwMemberRole, type OwMessageMember, type OwMintedAiToken, type OwMintedKey, type OwMySeat, type OwNamesMap, OwNetworkError, type OwOpener, type OwOpenerKind, type OwOpenerState, type OwOpenerSurface, type OwOpenersOptions, type OwPage, type OwPaidBy, type OwPhotoOptions, type OwPhotoPlan, type OwPlayerJoined, OwPreconditionFailedError, type OwPreparedPhoto, type OwProposal, type OwProposalAccepted, type OwProposalConflict, type OwProposalList, type OwProposalQuery, type OwProposalState, type OwProposeInput, type OwProposed, OwProposedError, type OwProposedMark, type OwProposedNewElement, type OwReadWorldFile, type OwReadWorldFileOptions, type OwReadingAids, type OwReadingAidsCharter, type OwReadingAidsDomain, type OwReadingAidsGuide, type OwReadingAidsHub, type OwRecord, type OwRecordMark, type OwRecordStory, type OwRemovalTicket, type OwRemovedImage, type OwRenderOptions, type OwReportGroup, type OwReportLine, type OwReportLineOptions, type OwReportLint, type OwReportParentKind, type OwReportThreads, type OwResyncReason, type OwReviewInput, type OwReviewed, type OwSearchResult, type OwSearchResults, type OwSeat, type OwSeatCreated, type OwSender, type OwSenderStatus, type OwServedReadingAids, type OwSignInBegin, type OwSignInBegun, type OwSignInComplete, OwSignInError, type OwSignInReason, type OwSignInResult, type OwSignInStorage, type OwSignedIn, type OwSortAddToRow, type OwSortAnswer, type OwSortAskRow, type OwSortLinkRow, type OwSortMakeRow, type OwSortNote, type OwSortRef, type OwSortRow, OwStaleProposalError, type OwStrand, type OwStrandSlot, type OwStrandWorld, type OwTool, type OwToolNeeds, type OwToolOpen, type OwTrailGround, type OwTrailHanger, type OwTrailInput, type OwTrailLayout, type OwTrailPin, type OwTrailPlace, type OwTrailSettings, type OwTrailSpiral, type OwTrailTier, type OwUploadedFile, type OwUploadedImage, OwV2Client, type OwView, type OwViewRow, type OwViewsTable, type OwWordPair, type OwWorldFileEntry, OwWorldFileError, type OwWorldFileReason, type OwWorldFileRow, type OwWorldFiles, type OwWorldGraph, type OwWorldIndex, type OwWorldKeyMember, type OwWorldKeyRow, type OwWorldLens, type OwWorldLensReading, type OwWorldLenses, type OwWorldLink, type OwWorldMeta, type OwWorldOrigin, type OwWorldProducer, type OwWorldProposalList, type OwWorldProposalQuery, type OwWorldProposalRow, type OwWorldPublicPage, type OwWorldSource, type OwWriteDoor, type OwWriteWorldFileOptions, type OwWriteWorldFileReport, PHOTO_MAX_BYTES, PHOTO_TYPES, PROPOSED_MARK, PUBLIC_FIELDS, type ParseError, type ParseOptions, type ParseResult, RECORD_FIELD, REVIEW_PROPOSED_LABEL, ROOM_PAIRS, type RevokeAllSessionsResponse, type RevokeSessionResponse, SPATIAL_TYPES, STRAND_FIELD, type SectionInfo, type StepBreakdown, TOOLS, TRAIL_TIERS, type TokenConsumeParams, type TokenConsumeResponse, TokenResource, type TokenStatus, type TokenTransport, VIEWS, WORLD_FILE_MAX_BYTES, WORLD_FILE_MAX_ENTRIES, WORLD_FILE_MEDIA_TYPE, type WorldCalendar, absYearForEraYear, absoluteYear, approxYearLength, base64url, breakdownStep, buildAskContext, buildWorldIndex, charterOf, compareInstants, dateOf, degreeOf, detectKeyKind, displayYear, domainsOf, doorWhere, doorsOf, dragField, draughtText, editedBy, elementAddress, elementColor, eraForStep, errorFromResponse, familyOf, fieldLabel, fileKindOf, findOwLinks, floorDiv, floorMod, formatDuration, formatMidLabel, formatStep, formatYearLabel, getElementIcon, getElementLabel, groupOf, handsOnAsProposed, hasUnseenRecipients, instantOf, intercalaryInYear, isAddressedTo, isAgentDoor, isCharterElement, isDemoKey, isKnownOf, isLeapYear, isLens, isMessage, isNote, isParseError, isRoomElement, isSentBy, isTemplate, isToEveryone, kindCanWrite, landingOf, layoutAround, layoutByKind, layoutByLinks3d, layoutOf, lensesInUse, lookupWorld, mapSpace, monthStartSteps, nfc, noteOf, openersFor, outDegreeOf, parseDate, parseErrorEnvelope, parseOwLink, pinExpectation, pkceChallenge, planPhoto, preparePhoto, proposedMarkOf, readCalendarConfig, readCalendarValue, readMarkOf, readOwLinkAt, readReportLine, readReportLines, readWorldFile, readingAidOf, recipientsOf, recordMarkOf, recordsOf, renderElement, reportThreadsOf, resolveCalendar, resolveCalendarLens, resolveEraDomains, resolveLens, roundHalfEven, senderStatus, simpleCaseFold, strandOf, threadOf, trailByPlace, typeWord, unplacedAround, unplacedByKind, unplacedByLinks3d, unreadFor, validateCalendarConfig, viewOf, weekdayForStep, worldCalendars, worldGraph, writeWorldFile, yearLength, yearStartStep };
|
package/dist/index.js
CHANGED
|
@@ -124,6 +124,16 @@ var OwApiError = class extends Error {
|
|
|
124
124
|
get isAuthError() {
|
|
125
125
|
return this.code === "invalid_credentials" || this.code === "key_revoked" || this.code === "world_gone";
|
|
126
126
|
}
|
|
127
|
+
/**
|
|
128
|
+
* The host in front of onlyworlds.com refused the request before the API saw it: a 403 whose body is an HTML
|
|
129
|
+
* page titled "Blocked", not the API's JSON envelope. Nothing was written. The host refuses text that holds a
|
|
130
|
+
* shell command such as `python -m`, `python -c`, `perl -e`, or `curl` or `wget` with an address right after
|
|
131
|
+
* a backtick, a semicolon or a pipe; such a command passes in a fenced code block whose first line names a
|
|
132
|
+
* language, or without the backtick. `code` is null (it is no API code) and `detail` keeps the page.
|
|
133
|
+
*/
|
|
134
|
+
get isHostBlocked() {
|
|
135
|
+
return isHostBlockedPage(this.status, this.detail);
|
|
136
|
+
}
|
|
127
137
|
/** 422s/400s name the offending param/field -- typos error loudly platform-wide. */
|
|
128
138
|
get isValidationError() {
|
|
129
139
|
return this.status === 422 || this.status === 400;
|
|
@@ -517,7 +527,12 @@ var OwSignInError = class extends Error {
|
|
|
517
527
|
if (opts.retryAfter !== void 0) this.retryAfter = opts.retryAfter;
|
|
518
528
|
}
|
|
519
529
|
};
|
|
530
|
+
function isHostBlockedPage(status, body) {
|
|
531
|
+
return status === 403 && typeof body === "string" && /<title[^>]*>\s*Blocked\s*<\/title>/i.test(body);
|
|
532
|
+
}
|
|
533
|
+
var HOST_BLOCKED_MESSAGE = 'The host in front of onlyworlds.com refused this request before the API saw it (a 403 page titled "Blocked"), and nothing was written. It refuses text that holds a shell command such as python -m, python -c, perl -e, or curl or wget with an address, right after a backtick, a semicolon or a pipe. Put such a command in a fenced code block whose first line names a language, or write it without the backtick.';
|
|
520
534
|
function parseErrorEnvelope(status, body, retryAfter = null) {
|
|
535
|
+
if (isHostBlockedPage(status, body)) return new OwApiError(status, null, HOST_BLOCKED_MESSAGE, null, body, null, null, retryAfter);
|
|
521
536
|
const env = body && typeof body === "object" ? body : {};
|
|
522
537
|
const nested = typeof env.error === "object" && env.error !== null ? env.error : void 0;
|
|
523
538
|
const code = env.code ?? nested?.code ?? (typeof env.error === "string" ? env.error : null) ?? null;
|
|
@@ -1831,8 +1846,10 @@ var OwV2Client = class {
|
|
|
1831
1846
|
}
|
|
1832
1847
|
/**
|
|
1833
1848
|
* DELETE /account/worlds/{worldId}/seats/{seatId} -- remove an agent seat: its sponsor or the
|
|
1834
|
-
* world's owner may. Its key and secret stop at once;
|
|
1835
|
-
*
|
|
1849
|
+
* world's owner may. Its key and secret stop at once; the Character it plays goes with it only
|
|
1850
|
+
* while it is as the join left one (made by the join, named as the seat, supertype `Agent` alone,
|
|
1851
|
+
* last written by the join, linked from nothing, played by no one else); any other stays, one
|
|
1852
|
+
* given to the seat to play included. Needs the client's `ow_a_` token.
|
|
1836
1853
|
*/
|
|
1837
1854
|
async removeSeat(worldId, seatId) {
|
|
1838
1855
|
if (this.keyKind !== "account") {
|
|
@@ -7085,6 +7102,7 @@ function spaceRows(elements) {
|
|
|
7085
7102
|
|
|
7086
7103
|
// src/layout-by-links-3d.ts
|
|
7087
7104
|
var BY_LINKS_3D_REST = 60;
|
|
7105
|
+
var BY_LINKS_3D_VERSION = 1;
|
|
7088
7106
|
var KEYS = ["held", "heldUnit"];
|
|
7089
7107
|
function layoutByLinks3d(graph, elements, options) {
|
|
7090
7108
|
refuseUnknownOptions("layoutByLinks3d", options, KEYS);
|
|
@@ -9411,6 +9429,7 @@ export {
|
|
|
9411
9429
|
AGENT_DOORS,
|
|
9412
9430
|
ASK_LIMITS,
|
|
9413
9431
|
BY_LINKS_3D_REST,
|
|
9432
|
+
BY_LINKS_3D_VERSION,
|
|
9414
9433
|
CALENDAR_FIELD,
|
|
9415
9434
|
CALENDAR_SUPERTYPE,
|
|
9416
9435
|
CHARTER_PAIRS,
|