@specstream/sdk 0.0.0-stage → 1.1.0

package/dist/index.js

@@ -0,0 +1,1009 @@
+import { requireWorkAuthorization } from "./authorization.js";
+export const FAMILIES = [
+    "local_business",
+    "creator",
+    "organization",
+    "storefront_product",
+    "app_listing",
+    "job_posting",
+    "scholarly_work",
+    "tender",
+    "grant",
+    "software_repository",
+    "software_package",
+    "dataset",
+    "clinical_trial",
+    "regulatory_document",
+    "vulnerability",
+    "book",
+    "podcast",
+    "web_page",
+    "knowledge_entity",
+    "person",
+];
+export const DEFAULT_BASE_URL = "https://api.specstream.ai";
+export class SpecstreamError extends Error {
+    status;
+    body;
+    code;
+    details;
+    constructor(message, status = null, body = null) {
+        super(message);
+        this.name = "SpecstreamError";
+        this.status = status;
+        this.body = body;
+        let parsed = body;
+        if (typeof parsed === "string") {
+            try {
+                parsed = JSON.parse(parsed);
+            }
+            catch {
+                parsed = null;
+            }
+        }
+        const candidate = parsed && typeof parsed === "object" && !Array.isArray(parsed)
+            ? parsed.error : null;
+        const error = candidate && typeof candidate === "object" && !Array.isArray(candidate)
+            ? candidate : {};
+        this.code = typeof error.code === "string" ? error.code : null;
+        this.details = error.details && typeof error.details === "object" && !Array.isArray(error.details)
+            ? { ...error.details } : {};
+    }
+}
+export function assertFamily(entityType) {
+    if (!FAMILIES.includes(entityType)) {
+        throw new Error(`unsupported entity_type ${entityType}`);
+    }
+    return entityType;
+}
+export class Client {
+    apiKey;
+    baseUrl;
+    fetchFn;
+    exportOrigin;
+    timeoutMs;
+    constructor(options) {
+        const key = (options.apiKey || "").trim();
+        if (!key) {
+            throw new SpecstreamError("SPECSTREAM_API_KEY is required");
+        }
+        this.apiKey = key;
+        this.baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\/+$/, "");
+        this.fetchFn = options.fetch ?? fetch;
+        this.exportOrigin = options.exportOrigin;
+        this.timeoutMs = options.timeoutMs ?? 150_000;
+        if (!Number.isSafeInteger(this.timeoutMs) || this.timeoutMs <= 0 || this.timeoutMs > 2_147_483_647) {
+            throw new SpecstreamError("timeoutMs must be a positive integer up to 2147483647");
+        }
+    }
+    families() {
+        return FAMILIES;
+    }
+    compile(q, locale = "en-US") {
+        return this.request("POST", "/v1/parse", { q, locale });
+    }
+    editSpec(ast, operations = []) {
+        return this.request("POST", "/v1/parse/from-chips", { ast, operations });
+    }
+    specOptions(target) {
+        return this.request("GET", "/v1/spec-options/" + encodeURIComponent(target));
+    }
+    getFind(findId) {
+        return this.request("GET", `/v1/finds/${encodeURIComponent(findId)}`);
+    }
+    revisit(findId, after = "", limit = 100) {
+        const query = new URLSearchParams({ after, limit: String(limit) });
+        return this.request("GET", `/v1/finds/${encodeURIComponent(findId)}/revisit?${query}`);
+    }
+    rows(findId, cursor = null, limit = 100) {
+        if (!Number.isSafeInteger(limit) || limit < 1 || limit > 100)
+            throw new Error("Row page limit must be an integer from 1 to 100");
+        if (cursor !== null && (typeof cursor !== "string" || !cursor || cursor.length > 2048))
+            throw new Error("Use the opaque next_cursor returned by this Delivery");
+        const query = new URLSearchParams({ limit: String(limit) });
+        if (cursor !== null)
+            query.set("cursor", cursor);
+        return this.request("GET", "/v1/finds/" + encodeURIComponent(findId) + "/rows?" + query);
+    }
+    export(findId, format = "csv") {
+        return this.request("POST", "/v1/finds/" + encodeURIComponent(findId) + "/export", { format });
+    }
+    /** Fetch a fresh one-use export. Account credentials never accompany its capability. */
+    async downloadExport(findId, format = "xlsx", maxBytes = 64 * 1024 * 1024) {
+        if (!Number.isSafeInteger(maxBytes) || maxBytes <= 0) {
+            throw new SpecstreamError("maxBytes must be a positive integer");
+        }
+        const exported = await this.export(findId, format);
+        const location = exported.download_url;
+        if (typeof location !== "string" || /[\x00-\x20\\]/.test(location) ||
+            /^https?:\/\/[^/]*@/i.test(location)) {
+            throw new SpecstreamError("Export returned an invalid download location");
+        }
+        let url;
+        try {
+            url = new URL(location);
+            const base = new URL(this.baseUrl);
+            const allowed = new Set([base.origin]);
+            if (this.exportOrigin !== undefined) {
+                const declared = new URL(this.exportOrigin);
+                if (!['http:', 'https:'].includes(declared.protocol) || declared.username ||
+                    declared.password || declared.search || declared.hash || declared.pathname !== '/') {
+                    throw new Error("invalid export origin");
+                }
+                allowed.add(declared.origin);
+            }
+            else if (base.origin === "https://api.specstream.ai") {
+                allowed.add("https://specstream.ai");
+            }
+            if (!allowed.has(url.origin) || !['http:', 'https:'].includes(url.protocol) ||
+                url.username || url.password || url.search || url.hash ||
+                !/^\/export\/[A-Za-z0-9_-]+$/.test(url.pathname)) {
+                throw new Error("untrusted download location");
+            }
+        }
+        catch {
+            throw new SpecstreamError("Export returned an untrusted download location");
+        }
+        try {
+            const response = await this.fetchFn(url.href, {
+                method: "GET", redirect: "error", credentials: "omit",
+                signal: AbortSignal.timeout(this.timeoutMs),
+                headers: { Accept: "*/*", "Accept-Encoding": "identity" },
+            });
+            if (response.status !== 200) {
+                await response.body?.cancel();
+                throw new SpecstreamError("Export download failed", response.status);
+            }
+            const reader = response.body?.getReader();
+            if (!reader)
+                throw new SpecstreamError("Export download returned no body", response.status);
+            const chunks = [];
+            let size = 0;
+            try {
+                for (;;) {
+                    const { done, value } = await reader.read();
+                    if (done)
+                        break;
+                    size += value.length;
+                    if (size > maxBytes) {
+                        await reader.cancel();
+                        throw new SpecstreamError("Export exceeds maxBytes", response.status);
+                    }
+                    chunks.push(value);
+                }
+            }
+            finally {
+                reader.releaseLock();
+            }
+            if (!size)
+                throw new SpecstreamError("Export download returned no body", response.status);
+            const bytes = new Uint8Array(size);
+            let offset = 0;
+            for (const chunk of chunks) {
+                bytes.set(chunk, offset);
+                offset += chunk.length;
+            }
+            return bytes;
+        }
+        catch (error) {
+            if (error instanceof SpecstreamError)
+                throw error;
+            throw new SpecstreamError("Export download transport failed");
+        }
+    }
+    // BEGIN GENERATED LIFECYCLE
+    getVocabulary() {
+        let path = `/v1/vocabulary`;
+        return this.request("GET", path);
+    }
+    workspaceListAuditEvents(query = {}) {
+        let path = `/v1/workspace/audit`;
+        const queryString = new URLSearchParams();
+        for (const [key, value] of Object.entries(query))
+            if (value !== undefined && value !== null)
+                queryString.set(key, String(value));
+        if (queryString.size)
+            path += "?" + queryString.toString();
+        return this.request("GET", path);
+    }
+    understandLive(request) {
+        let path = `/v1/understand`;
+        return this.request("POST", path, request);
+    }
+    workspaceSearch(query) {
+        let path = `/v1/search`;
+        const queryString = new URLSearchParams();
+        for (const [key, value] of Object.entries(query))
+            if (value !== undefined && value !== null)
+                queryString.set(key, String(value));
+        if (queryString.size)
+            path += "?" + queryString.toString();
+        return this.request("GET", path);
+    }
+    workspaceListNotifications(query = {}) {
+        let path = `/v1/workspace/notifications`;
+        const queryString = new URLSearchParams();
+        for (const [key, value] of Object.entries(query))
+            if (value !== undefined && value !== null)
+                queryString.set(key, String(value));
+        if (queryString.size)
+            path += "?" + queryString.toString();
+        return this.request("GET", path);
+    }
+    workspaceUpdateNotification(identifier, request) {
+        let path = `/v1/workspace/notifications/${encodeURIComponent(identifier)}`;
+        return this.request("PATCH", path, request);
+    }
+    workspaceReadNotifications(request) {
+        let path = `/v1/workspace/notifications/read`;
+        return this.request("POST", path, request);
+    }
+    getMe() {
+        let path = `/v1/me`;
+        return this.request("GET", path);
+    }
+    getAccount() {
+        let path = `/v1/account`;
+        return this.request("GET", path);
+    }
+    listAccountKeys() {
+        let path = `/v1/account/keys`;
+        return this.request("GET", path);
+    }
+    createAccountKey(request) {
+        let path = `/v1/account/keys`;
+        return this.request("POST", path, request);
+    }
+    updateAccountSpend(request) {
+        let path = `/v1/account/spend`;
+        return this.request("PATCH", path, request);
+    }
+    revokeAccountKey(keyId) {
+        let path = `/v1/account/keys/${encodeURIComponent(keyId)}`;
+        return this.request("DELETE", path);
+    }
+    getFindCommerce(findId) {
+        let path = `/v1/finds/${encodeURIComponent(findId)}/commerce`;
+        return this.request("GET", path);
+    }
+    reconcileFindCommerce(findId) {
+        let path = `/v1/finds/${encodeURIComponent(findId)}/reconcile`;
+        return this.request("POST", path);
+    }
+    cancelFind(findId) {
+        let path = `/v1/finds/${encodeURIComponent(findId)}/cancel`;
+        return this.request("POST", path);
+    }
+    shareFind(findId, request) {
+        let path = `/v1/finds/${encodeURIComponent(findId)}/share`;
+        return this.request("POST", path, request);
+    }
+    revokeShare(shareId, request) {
+        let path = `/v1/share/${encodeURIComponent(shareId)}/revoke`;
+        return this.request("POST", path, request);
+    }
+    createSpec(request) {
+        let path = `/v1/specs`;
+        return this.request("POST", path, request);
+    }
+    listSpecs(query = {}) {
+        let path = `/v1/specs`;
+        const queryString = new URLSearchParams();
+        for (const [key, value] of Object.entries(query))
+            if (value !== undefined && value !== null)
+                queryString.set(key, String(value));
+        if (queryString.size)
+            path += "?" + queryString.toString();
+        return this.request("GET", path);
+    }
+    getSpec(specId) {
+        let path = `/v1/specs/${encodeURIComponent(specId)}`;
+        return this.request("GET", path);
+    }
+    reviseSpec(specId, request) {
+        let path = `/v1/specs/${encodeURIComponent(specId)}/revisions`;
+        return this.request("POST", path, request);
+    }
+    listSpecRevisions(specId, query = {}) {
+        let path = `/v1/specs/${encodeURIComponent(specId)}/revisions`;
+        const queryString = new URLSearchParams();
+        for (const [key, value] of Object.entries(query))
+            if (value !== undefined && value !== null)
+                queryString.set(key, String(value));
+        if (queryString.size)
+            path += "?" + queryString.toString();
+        return this.request("GET", path);
+    }
+    getSpecRevision(specId, revisionId) {
+        let path = `/v1/specs/${encodeURIComponent(specId)}/revisions/${encodeURIComponent(revisionId)}`;
+        return this.request("GET", path);
+    }
+    archiveSpec(specId, request) {
+        let path = `/v1/specs/${encodeURIComponent(specId)}`;
+        return this.request("PATCH", path, request);
+    }
+    listSpecFinds(specId, query = {}) {
+        let path = `/v1/specs/${encodeURIComponent(specId)}/finds`;
+        const queryString = new URLSearchParams();
+        for (const [key, value] of Object.entries(query))
+            if (value !== undefined && value !== null)
+                queryString.set(key, String(value));
+        if (queryString.size)
+            path += "?" + queryString.toString();
+        return this.request("GET", path);
+    }
+    getFindLineage(findId) {
+        let path = `/v1/finds/${encodeURIComponent(findId)}/lineage`;
+        return this.request("GET", path);
+    }
+    getDelivery(findId) {
+        let path = `/v1/finds/${encodeURIComponent(findId)}/delivery`;
+        return this.request("GET", path);
+    }
+    getFindDecisions(findId, query = {}) {
+        let path = `/v1/finds/${encodeURIComponent(findId)}/decisions`;
+        const queryString = new URLSearchParams();
+        for (const [key, value] of Object.entries(query))
+            if (value !== undefined && value !== null)
+                queryString.set(key, String(value));
+        if (queryString.size)
+            path += "?" + queryString.toString();
+        return this.request("GET", path);
+    }
+    createProject(request) {
+        let path = `/v1/projects`;
+        return this.request("POST", path, request);
+    }
+    listProjects(query = {}) {
+        let path = `/v1/projects`;
+        const queryString = new URLSearchParams();
+        for (const [key, value] of Object.entries(query))
+            if (value !== undefined && value !== null)
+                queryString.set(key, String(value));
+        if (queryString.size)
+            path += "?" + queryString.toString();
+        return this.request("GET", path);
+    }
+    getProject(projectId) {
+        let path = `/v1/projects/${encodeURIComponent(projectId)}`;
+        return this.request("GET", path);
+    }
+    updateProject(projectId, request) {
+        let path = `/v1/projects/${encodeURIComponent(projectId)}`;
+        return this.request("PATCH", path, request);
+    }
+    putProjectMember(projectId, request) {
+        let path = `/v1/projects/${encodeURIComponent(projectId)}/members`;
+        return this.request("POST", path, request);
+    }
+    listProjectMembers(projectId, query = {}) {
+        let path = `/v1/projects/${encodeURIComponent(projectId)}/members`;
+        const queryString = new URLSearchParams();
+        for (const [key, value] of Object.entries(query))
+            if (value !== undefined && value !== null)
+                queryString.set(key, String(value));
+        if (queryString.size)
+            path += "?" + queryString.toString();
+        return this.request("GET", path);
+    }
+    revokeProjectMember(projectId, accountId) {
+        let path = `/v1/projects/${encodeURIComponent(projectId)}/members/${encodeURIComponent(accountId)}`;
+        return this.request("DELETE", path);
+    }
+    listCustomerWebhooks() {
+        let path = `/v1/account/webhooks`;
+        return this.request("GET", path);
+    }
+    createCustomerWebhook(request) {
+        let path = `/v1/account/webhooks`;
+        return this.request("POST", path, request);
+    }
+    revokeCustomerWebhook(hookId) {
+        let path = `/v1/account/webhooks/${encodeURIComponent(hookId)}`;
+        return this.request("DELETE", path);
+    }
+    getCapacityCatalog() {
+        let path = `/v1/capacity/catalog`;
+        return this.request("GET", path);
+    }
+    getCapacityBalance(query = {}) {
+        let path = `/v1/capacity/balance`;
+        const queryString = new URLSearchParams();
+        for (const [key, value] of Object.entries(query))
+            if (value !== undefined && value !== null)
+                queryString.set(key, String(value));
+        if (queryString.size)
+            path += "?" + queryString.toString();
+        return this.request("GET", path);
+    }
+    getCapacityEntitlements(query = {}) {
+        let path = `/v1/capacity/entitlements`;
+        const queryString = new URLSearchParams();
+        for (const [key, value] of Object.entries(query))
+            if (value !== undefined && value !== null)
+                queryString.set(key, String(value));
+        if (queryString.size)
+            path += "?" + queryString.toString();
+        return this.request("GET", path);
+    }
+    getCapacityReferral() {
+        let path = `/v1/capacity/referral`;
+        return this.request("GET", path);
+    }
+    captureCapacityReferral(request) {
+        let path = `/v1/capacity/referral/visit`;
+        return this.request("POST", path, request);
+    }
+    getCapacityHistory() {
+        let path = `/v1/capacity/history`;
+        return this.request("GET", path);
+    }
+    claimFreeCapacity() {
+        let path = `/v1/capacity/free`;
+        return this.request("POST", path);
+    }
+    setCapacityBudget(request) {
+        let path = `/v1/capacity/budget`;
+        return this.request("PATCH", path, request);
+    }
+    quoteCapacityWork(request) {
+        let path = `/v1/capacity/quotes`;
+        return this.request("POST", path, request);
+    }
+    getCapacityQuote(quoteId) {
+        let path = `/v1/capacity/quotes/${encodeURIComponent(quoteId)}`;
+        return this.request("GET", path);
+    }
+    authorizeCapacityWork(request) {
+        let path = `/v1/capacity/executions`;
+        requireWorkAuthorization(request);
+        return this.request("POST", path, request);
+    }
+    getCapacityRequest(requestKey, query = {}) {
+        let path = `/v1/capacity/requests/${encodeURIComponent(requestKey)}`;
+        const queryString = new URLSearchParams();
+        for (const [key, value] of Object.entries(query))
+            if (value !== undefined && value !== null)
+                queryString.set(key, String(value));
+        if (queryString.size)
+            path += "?" + queryString.toString();
+        return this.request("GET", path);
+    }
+    getCapacityExecution(findId) {
+        let path = `/v1/capacity/executions/${encodeURIComponent(findId)}`;
+        return this.request("GET", path);
+    }
+    createCapacityFunding(request) {
+        let path = `/v1/capacity/funding`;
+        return this.request("POST", path, request);
+    }
+    getCapacityFunding(fundingId) {
+        let path = `/v1/capacity/funding/${encodeURIComponent(fundingId)}`;
+        return this.request("GET", path);
+    }
+    cancelCapacityFunding(fundingId) {
+        let path = `/v1/capacity/funding/${encodeURIComponent(fundingId)}`;
+        return this.request("DELETE", path);
+    }
+    getCapacityMembership() {
+        let path = `/v1/capacity/membership`;
+        return this.request("GET", path);
+    }
+    changeCapacityMembership(request) {
+        let path = `/v1/capacity/membership`;
+        return this.request("POST", path, request);
+    }
+    createCapacityAuthority(request) {
+        let path = `/v1/capacity/authorities`;
+        return this.request("POST", path, request);
+    }
+    revokeCapacityAuthority(authorityId) {
+        let path = `/v1/capacity/authorities/${encodeURIComponent(authorityId)}`;
+        return this.request("DELETE", path);
+    }
+    createCapacitySchedule(request) {
+        let path = `/v1/capacity/schedules`;
+        return this.request("POST", path, request);
+    }
+    listCapacitySchedules(query = {}) {
+        let path = `/v1/capacity/schedules`;
+        const queryString = new URLSearchParams();
+        for (const [key, value] of Object.entries(query))
+            if (value !== undefined && value !== null)
+                queryString.set(key, String(value));
+        if (queryString.size)
+            path += "?" + queryString.toString();
+        return this.request("GET", path);
+    }
+    updateCapacitySchedule(scheduleId, request) {
+        let path = `/v1/capacity/schedules/${encodeURIComponent(scheduleId)}`;
+        return this.request("PATCH", path, request);
+    }
+    listCapacityOccurrences(scheduleId, query = {}) {
+        let path = `/v1/capacity/schedules/${encodeURIComponent(scheduleId)}/occurrences`;
+        const queryString = new URLSearchParams();
+        for (const [key, value] of Object.entries(query))
+            if (value !== undefined && value !== null)
+                queryString.set(key, String(value));
+        if (queryString.size)
+            path += "?" + queryString.toString();
+        return this.request("GET", path);
+    }
+    runCapacityScheduleNow(scheduleId) {
+        let path = `/v1/capacity/schedules/${encodeURIComponent(scheduleId)}/run`;
+        return this.request("POST", path);
+    }
+    createCapacityRefundClaim(request) {
+        let path = `/v1/capacity/refund-claims`;
+        return this.request("POST", path, request);
+    }
+    listCapacityRefundClaims() {
+        let path = `/v1/capacity/refund-claims`;
+        return this.request("GET", path);
+    }
+    getCapacityRefundClaim(claimId) {
+        let path = `/v1/capacity/refund-claims/${encodeURIComponent(claimId)}`;
+        return this.request("GET", path);
+    }
+    requestCapacityCustomPlan(request) {
+        let path = `/v1/capacity/enterprise`;
+        return this.request("POST", path, request);
+    }
+    getCapacityStoreConfig() {
+        let path = `/v1/capacity/stores/config`;
+        return this.request("GET", path);
+    }
+    verifyCapacityStorePurchase(request) {
+        let path = `/v1/capacity/stores/purchases`;
+        return this.request("POST", path, request);
+    }
+    restoreCapacityStorePurchases(request) {
+        let path = `/v1/capacity/stores/restore`;
+        return this.request("POST", path, request);
+    }
+    transferCapacityStoreToCard(request) {
+        let path = `/v1/capacity/stores/card-transfer`;
+        return this.request("POST", path, request);
+    }
+    createSpecLink(specId, request) {
+        let path = `/v1/specs/${encodeURIComponent(specId)}/links`;
+        return this.request("POST", path, request);
+    }
+    getSharedSpec(token) {
+        let path = `/v1/shared-specs/${encodeURIComponent(token)}`;
+        return this.request("GET", path);
+    }
+    revokeSpecLink(specId, linkId) {
+        let path = `/v1/specs/${encodeURIComponent(specId)}/links/${encodeURIComponent(linkId)}/revoke`;
+        return this.request("POST", path);
+    }
+    workspaceResearchInput(findId) {
+        let path = `/v1/workspace/collections/${encodeURIComponent(findId)}/input`;
+        return this.request("GET", path);
+    }
+    workspaceSetScheduleDelivery(scheduleId, request) {
+        let path = `/v1/workspace/schedules/${encodeURIComponent(scheduleId)}/delivery`;
+        return this.request("PATCH", path, request);
+    }
+    workspaceListCollections(query = {}) {
+        let path = `/v1/workspace/collections`;
+        const queryString = new URLSearchParams();
+        for (const [key, value] of Object.entries(query))
+            if (value !== undefined && value !== null)
+                queryString.set(key, String(value));
+        if (queryString.size)
+            path += "?" + queryString.toString();
+        return this.request("GET", path);
+    }
+    workspaceReadCollection(collectionId) {
+        let path = `/v1/workspace/collections/${encodeURIComponent(collectionId)}`;
+        return this.request("GET", path);
+    }
+    workspaceCombineCollections(request) {
+        let path = `/v1/workspace/collections/combine`;
+        return this.request("POST", path, request);
+    }
+    workspaceCopyCollection(collectionId, request) {
+        let path = `/v1/workspace/collections/${encodeURIComponent(collectionId)}/copy`;
+        return this.request("POST", path, request);
+    }
+    workspaceFilterCollection(collectionId, request) {
+        let path = `/v1/workspace/collections/${encodeURIComponent(collectionId)}/filter`;
+        return this.request("POST", path, request);
+    }
+    workspaceListViews(collectionId) {
+        let path = `/v1/workspace/views/${encodeURIComponent(collectionId)}`;
+        return this.request("GET", path);
+    }
+    workspaceSaveView(collectionId, request) {
+        let path = `/v1/workspace/views/${encodeURIComponent(collectionId)}`;
+        return this.request("PUT", path, request);
+    }
+    workspaceListStars() {
+        let path = `/v1/workspace/stars`;
+        return this.request("GET", path);
+    }
+    workspaceStarItem(request) {
+        let path = `/v1/workspace/stars`;
+        return this.request("PUT", path, request);
+    }
+    workspaceListNotes(query = {}) {
+        let path = `/v1/workspace/notes`;
+        const queryString = new URLSearchParams();
+        for (const [key, value] of Object.entries(query))
+            if (value !== undefined && value !== null)
+                queryString.set(key, String(value));
+        if (queryString.size)
+            path += "?" + queryString.toString();
+        return this.request("GET", path);
+    }
+    workspaceAddNote(request) {
+        let path = `/v1/workspace/notes`;
+        return this.request("POST", path, request);
+    }
+    workspaceResolveNote(noteId, request) {
+        let path = `/v1/workspace/notes/${encodeURIComponent(noteId)}`;
+        return this.request("PATCH", path, request);
+    }
+    workspaceEditNote(noteId, request) {
+        let path = `/v1/workspace/notes/${encodeURIComponent(noteId)}`;
+        return this.request("PUT", path, request);
+    }
+    workspaceDeleteNote(noteId, request) {
+        let path = `/v1/workspace/notes/${encodeURIComponent(noteId)}`;
+        return this.request("DELETE", path, request);
+    }
+    workspaceRegisterWebPushSubscription(request) {
+        let path = `/v1/workspace/push/subscriptions`;
+        return this.request("POST", path, request);
+    }
+    workspacePushCapabilities() {
+        let path = `/v1/workspace/push/capabilities`;
+        return this.request("GET", path);
+    }
+    workspaceListPushDevices() {
+        let path = `/v1/workspace/push/devices`;
+        return this.request("GET", path);
+    }
+    workspaceRegisterPushDevice(request) {
+        let path = `/v1/workspace/push/devices`;
+        return this.request("POST", path, request);
+    }
+    workspaceRevokePushDevice(deviceId) {
+        let path = `/v1/workspace/push/devices/${encodeURIComponent(deviceId)}`;
+        return this.request("DELETE", path);
+    }
+    workspaceListYourFields(collectionId) {
+        let path = `/v1/workspace/collections/${encodeURIComponent(collectionId)}/fields`;
+        return this.request("GET", path);
+    }
+    workspaceSaveYourFields(collectionId, request) {
+        let path = `/v1/workspace/collections/${encodeURIComponent(collectionId)}/fields`;
+        return this.request("PUT", path, request);
+    }
+    workspaceSetYourFieldValue(collectionId, request) {
+        let path = `/v1/workspace/collections/${encodeURIComponent(collectionId)}/fields/values`;
+        return this.request("PUT", path, request);
+    }
+    beginConnectionAuthorization(provider) {
+        let path = `/v1/connections/${encodeURIComponent(provider)}/authorize`;
+        return this.request("POST", path);
+    }
+    disconnectConnection(connectionId) {
+        let path = `/v1/connections/${encodeURIComponent(connectionId)}`;
+        return this.request("DELETE", path);
+    }
+    listCloudImports() {
+        let path = `/v1/imports/cloud`;
+        return this.request("GET", path);
+    }
+    listConnectedTools() {
+        let path = `/v1/connections/catalog`;
+        return this.request("GET", path);
+    }
+    listConnections() {
+        let path = `/v1/connections`;
+        return this.request("GET", path);
+    }
+    listConnectionDestinations(connectionId, query = {}) {
+        let path = `/v1/connections/${encodeURIComponent(connectionId)}/destinations`;
+        const queryString = new URLSearchParams();
+        for (const [key, value] of Object.entries(query))
+            if (value !== undefined && value !== null)
+                queryString.set(key, String(value));
+        if (queryString.size)
+            path += "?" + queryString.toString();
+        return this.request("GET", path);
+    }
+    getConnectionColumns(connectionId, request) {
+        let path = `/v1/connections/${encodeURIComponent(connectionId)}/columns`;
+        return this.request("POST", path, request);
+    }
+    saveConnectionDestination(connectionId, request) {
+        let path = `/v1/connections/${encodeURIComponent(connectionId)}/destination`;
+        return this.request("POST", path, request);
+    }
+    sendToDestination(connectionId, request) {
+        let path = `/v1/connections/${encodeURIComponent(connectionId)}/send`;
+        return this.request("POST", path, request);
+    }
+    reconcileDestinationExport(connectionId, exportId) {
+        let path = `/v1/connections/${encodeURIComponent(connectionId)}/exports/${encodeURIComponent(exportId)}/reconcile`;
+        return this.request("POST", path);
+    }
+    listDestinationExports() {
+        let path = `/v1/connections/exports`;
+        return this.request("GET", path);
+    }
+    createDestinationSync(request) {
+        let path = `/v1/destination-syncs`;
+        return this.request("POST", path, request);
+    }
+    updateDestinationSync(syncId, request) {
+        let path = `/v1/destination-syncs/${encodeURIComponent(syncId)}`;
+        return this.request("PATCH", path, request);
+    }
+    listDestinationSyncs() {
+        let path = `/v1/destination-syncs`;
+        return this.request("GET", path);
+    }
+    previewCloudList(request) {
+        let path = `/v1/imports/cloud/preview`;
+        return this.request("POST", path, request);
+    }
+    importCloudList(request) {
+        let path = `/v1/imports/cloud`;
+        return this.request("POST", path, request);
+    }
+    updateCloudImport(importId, request) {
+        let path = `/v1/imports/cloud/${encodeURIComponent(importId)}`;
+        return this.request("PATCH", path, request);
+    }
+    workspaceInviteMember(request) {
+        let path = `/v1/workspace/invitations`;
+        return this.request("POST", path, request);
+    }
+    importFileCommand(request) {
+        let path = `/v1/imports/file`;
+        return this.request("POST", path, request);
+    }
+    workspaceActivity(query = {}) {
+        let path = `/v1/activity`;
+        const queryString = new URLSearchParams();
+        for (const [key, value] of Object.entries(query))
+            if (value !== undefined && value !== null)
+                queryString.set(key, String(value));
+        if (queryString.size)
+            path += "?" + queryString.toString();
+        return this.request("GET", path);
+    }
+    workspaceRelationships(collectionId, query = {}) {
+        let path = `/v1/workspace/collections/${encodeURIComponent(collectionId)}/relationships`;
+        const queryString = new URLSearchParams();
+        for (const [key, value] of Object.entries(query))
+            if (value !== undefined && value !== null)
+                queryString.set(key, String(value));
+        if (queryString.size)
+            path += "?" + queryString.toString();
+        return this.request("GET", path);
+    }
+    workspaceSaveRelationships(collectionId, request) {
+        let path = `/v1/workspace/collections/${encodeURIComponent(collectionId)}/relationships`;
+        return this.request("PUT", path, request);
+    }
+    workspaceReportResult(collectionId, request) {
+        let path = `/v1/workspace/collections/${encodeURIComponent(collectionId)}/reports`;
+        return this.request("POST", path, request);
+    }
+    listRequestTemplates(query = {}) {
+        let path = `/v1/request-templates`;
+        const queryString = new URLSearchParams();
+        for (const [key, value] of Object.entries(query))
+            if (value !== undefined && value !== null)
+                queryString.set(key, String(value));
+        if (queryString.size)
+            path += "?" + queryString.toString();
+        return this.request("GET", path);
+    }
+    workspaceCollectionChanges(collectionId) {
+        let path = `/v1/workspace/collections/${encodeURIComponent(collectionId)}/changes`;
+        return this.request("GET", path);
+    }
+    workspaceListPasskeys() {
+        let path = `/v1/workspace/security/passkeys`;
+        return this.request("GET", path);
+    }
+    workspaceRegisterPasskeyOptions() {
+        let path = `/v1/workspace/security/passkeys/options`;
+        return this.request("POST", path);
+    }
+    workspaceRegisterPasskey(request) {
+        let path = `/v1/workspace/security/passkeys`;
+        return this.request("POST", path, request);
+    }
+    workspaceNamePasskey(credentialId, request) {
+        let path = `/v1/workspace/security/passkeys/${encodeURIComponent(credentialId)}`;
+        return this.request("PATCH", path, request);
+    }
+    workspaceDeletePasskey(credentialId) {
+        let path = `/v1/workspace/security/passkeys/${encodeURIComponent(credentialId)}`;
+        return this.request("DELETE", path);
+    }
+    workspacePasskeySignInOptions() {
+        let path = `/v1/workspace/auth/passkey/options`;
+        return this.request("POST", path);
+    }
+    workspacePasskeySignIn(request) {
+        let path = `/v1/workspace/auth/passkey/verify`;
+        return this.request("POST", path, request);
+    }
+    workspaceListSSODomains() {
+        let path = `/v1/workspace/security/sso`;
+        return this.request("GET", path);
+    }
+    workspaceAddSSODomain(request) {
+        let path = `/v1/workspace/security/sso`;
+        return this.request("POST", path, request);
+    }
+    workspaceVerifySSODomain(domainId) {
+        let path = `/v1/workspace/security/sso/${encodeURIComponent(domainId)}/verify`;
+        return this.request("POST", path);
+    }
+    workspaceConfigureSSO(domainId, request) {
+        let path = `/v1/workspace/security/sso/${encodeURIComponent(domainId)}/provider`;
+        return this.request("PUT", path, request);
+    }
+    workspaceSetSSOPolicy(domainId, request) {
+        let path = `/v1/workspace/security/sso/${encodeURIComponent(domainId)}`;
+        return this.request("PATCH", path, request);
+    }
+    workspaceStartSSO(request) {
+        let path = `/v1/workspace/auth/sso/start`;
+        return this.request("POST", path, request);
+    }
+    workspaceRotateSCIMToken(domainId) {
+        let path = `/v1/workspace/security/sso/${encodeURIComponent(domainId)}/scim/token`;
+        return this.request("POST", path);
+    }
+    workspaceRevokeSCIMToken(domainId) {
+        let path = `/v1/workspace/security/sso/${encodeURIComponent(domainId)}/scim/token`;
+        return this.request("DELETE", path);
+    }
+    workspaceReadSCIMMappings(domainId) {
+        let path = `/v1/workspace/security/sso/${encodeURIComponent(domainId)}/scim/mappings`;
+        return this.request("GET", path);
+    }
+    workspaceSetSCIMMappings(domainId, request) {
+        let path = `/v1/workspace/security/sso/${encodeURIComponent(domainId)}/scim/mappings`;
+        return this.request("PUT", path, request);
+    }
+    workspaceReadPhoto() {
+        let path = `/v1/workspace/profile/photo`;
+        return this.request("GET", path);
+    }
+    workspaceDeletePhoto() {
+        let path = `/v1/workspace/profile/photo`;
+        return this.request("DELETE", path);
+    }
+    workspaceStartNativeProvider(request) {
+        let path = `/v1/workspace/auth/native/start`;
+        return this.request("POST", path, request);
+    }
+    workspaceRedeemNativeProvider(request) {
+        let path = `/v1/workspace/auth/native/redeem`;
+        return this.request("POST", path, request);
+    }
+    workspacePlacementAllowance() {
+        let path = `/v1/workspace/placement/allowance`;
+        return this.request("GET", path);
+    }
+    workspaceQuotePlacement(importId) {
+        let path = `/v1/workspace/imports/${encodeURIComponent(importId)}/placement/quote`;
+        return this.request("POST", path);
+    }
+    workspaceStartPlacement(importId, request) {
+        let path = `/v1/workspace/imports/${encodeURIComponent(importId)}/placement`;
+        return this.request("POST", path, request);
+    }
+    workspacePlacementStatus(importId, placementId) {
+        let path = `/v1/workspace/imports/${encodeURIComponent(importId)}/placement/${encodeURIComponent(placementId)}`;
+        return this.request("GET", path);
+    }
+    teachWebSource(request) {
+        let path = `/v1/imports/web/sources`;
+        return this.request("POST", path, request);
+    }
+    listWebSources() {
+        let path = `/v1/imports/web/sources`;
+        return this.request("GET", path);
+    }
+    getWebSource(sourceId) {
+        let path = `/v1/imports/web/sources/${encodeURIComponent(sourceId)}`;
+        return this.request("GET", path);
+    }
+    previewWebSource(sourceId) {
+        let path = `/v1/imports/web/sources/${encodeURIComponent(sourceId)}/previews`;
+        return this.request("POST", path);
+    }
+    getWebSourcePreview(previewId) {
+        let path = `/v1/imports/web/previews/${encodeURIComponent(previewId)}`;
+        return this.request("GET", path);
+    }
+    saveWebSourceList(request) {
+        let path = `/v1/imports/web/lists`;
+        return this.request("POST", path, request);
+    }
+    getReconciliationFields(collectionId) {
+        let path = `/v1/reconciliation/collections/${encodeURIComponent(collectionId)}/fields`;
+        return this.request("GET", path);
+    }
+    listReconciliations(collectionId) {
+        let path = `/v1/reconciliation/collections/${encodeURIComponent(collectionId)}/comparisons`;
+        return this.request("GET", path);
+    }
+    prepareReconciliation(request) {
+        let path = `/v1/reconciliation/comparisons`;
+        return this.request("POST", path, request);
+    }
+    getReconciliation(comparisonId) {
+        let path = `/v1/reconciliation/comparisons/${encodeURIComponent(comparisonId)}`;
+        return this.request("GET", path);
+    }
+    applyReconciliation(comparisonId, request) {
+        let path = `/v1/reconciliation/comparisons/${encodeURIComponent(comparisonId)}/apply`;
+        return this.request("POST", path, request);
+    }
+    getReconciledInput(importId) {
+        let path = `/v1/reconciliation/imports/${encodeURIComponent(importId)}`;
+        return this.request("GET", path);
+    }
+    // END GENERATED LIFECYCLE
+    headers() {
+        const token = this.apiKey.toLowerCase().startsWith("bearer ")
+            ? this.apiKey
+            : `Bearer ${this.apiKey}`;
+        return {
+            Authorization: token,
+            Accept: "application/json",
+            "Content-Type": "application/json",
+            "User-Agent": "specstream-typescript/1.1.0",
+        };
+    }
+    async request(method, path, body) {
+        const url = this.baseUrl + path;
+        let response;
+        let text;
+        try {
+            response = await this.fetchFn(url, {
+                method,
+                headers: this.headers(),
+                redirect: "error",
+                signal: AbortSignal.timeout(this.timeoutMs),
+                body: body === undefined ? undefined : JSON.stringify(body),
+            });
+            text = await response.text();
+        }
+        catch (error) {
+            throw new SpecstreamError(method + " " + path + " transport failed", null, error);
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            throw new SpecstreamError(method + " " + path + " returned invalid JSON", response.status, text);
+        }
+        if (!response.ok) {
+            throw new SpecstreamError(method + " " + path + " failed with HTTP " + response.status, response.status, parsed);
+        }
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+            throw new SpecstreamError(method + " " + path + " returned non-object JSON", response.status, parsed);
+        }
+        const envelope = parsed;
+        if (envelope.error != null || !envelope.data || typeof envelope.data !== "object" || Array.isArray(envelope.data)) {
+            throw new SpecstreamError(method + " " + path + " returned an invalid success envelope", response.status, parsed);
+        }
+        return envelope.data;
+    }
+}
+export default Client;