@fonoster/types 0.27.0 → 0.31.0

package/dist/applications.types.d.ts

@@ -19,26 +19,67 @@
 import { BaseApiObject, ListRequest, ListResponse } from "./common";
 import { Flatten } from "./utils";
 declare enum ApplicationType {
-    EXTERNAL = "EXTERNAL",
+    STREAM = "STREAM",
     AUTOPILOT = "AUTOPILOT"
 }
 declare enum ExpectedTextType {
     EXACT = "EXACT",
     SIMILAR = "SIMILAR"
 }
-type Application = {
+/** Speech defaults of an application; voices and models are catalog ids. */
+type SpeechDefaults = {
+    voice?: string;
+    language?: string;
+    sttModel?: string;
+    ttsModel?: string;
+    silenceTimeoutMs?: number;
+    patience?: "low" | "normal" | "high";
+};
+type AudioFormat = {
+    codec: "pcm16" | "pcmu";
+    rate: number;
+};
+type AppListener = {
+    url: string;
+    tracks?: "inbound" | "outbound" | "both";
+};
+type RecordingPolicy = "off" | "on" | "consent";
+/** An audio filter run on the caller's audio before STT (voice-session, "Audio filters"). */
+type AudioFilter = {
+    name: string;
+    options?: Record<string, unknown>;
+};
+/** Answering-machine detection: one `amd.result` event per call. */
+type AmdSettings = {
+    enabled: boolean;
+    /** Caller audio to classify in ms (default 4000; 500 to 15000). */
+    windowMs?: number;
+};
+/** The application model (voice-session G2): a stream or an Autopilot agent. */
+type SessionAppFields = {
+    /** ws:// or wss:// URL AppBridge dials (Autopilot agents: the hosted Autopilot). */
+    url?: string;
+    /** The stream's wire protocol (default fonoster). */
+    protocol?: "fonoster" | "twilio";
+    speech?: SpeechDefaults;
+    audio?: AudioFormat;
+    fallbackAppRef?: string;
+    fallbackMessage?: string;
+    listeners?: AppListener[];
+    /** Empty inherits the workspace's policy. */
+    recording?: RecordingPolicy | "";
+    /** Off when unset. */
+    amd?: AmdSettings;
+    /** Audio filters in order. An update replaces the whole app: leave them out and they are cleared. */
+    filters?: AudioFilter[];
+};
+type Application = SessionAppFields & {
     ref: string;
     name: string;
     type: ApplicationType;
+    /** The last characters of the signing secret; the secret itself is never read back. */
+    signingSecretHint?: string;
     endpoint?: string;
-    textToSpeech?: {
-        productRef: string;
-        config: Record<string, unknown>;
-    };
-    speechToText?: {
-        productRef: string;
-        config: Record<string, unknown>;
-    };
     intelligence?: {
         productRef: string;
         config: Record<string, unknown>;
@@ -46,30 +87,41 @@ type Application = {
     createdAt: Date;
     updatedAt: Date;
 };
-type CreateApplicationRequest = {
+type CreateApplicationRequest = SessionAppFields & {
     name: string;
     type: ApplicationType;
     endpoint?: string;
-    textToSpeech?: {
-        productRef: string;
-        config: Record<string, unknown>;
-    };
-    speechToText?: {
-        productRef: string;
-        config: Record<string, unknown>;
-    };
+    /** Autopilot apps: the agent (sessionAgentSchema); productRef is derived from its model. */
     intelligence?: {
-        productRef: string;
-        credentials: Record<string, unknown>;
+        productRef?: string;
         config: Record<string, unknown>;
     };
 };
 type UpdateApplicationRequest = Flatten<BaseApiObject & Partial<CreateApplicationRequest>>;
 type ListApplicationsRequest = ListRequest;
+type CreateApplicationResponse = {
+    ref: string;
+    /** Shown only here and on rotation. */
+    signingSecret?: string;
+    signingSecretHint?: string;
+};
+type UpdateApplicationResponse = {
+    ref: string;
+    /** Set only when the update generated a new secret (the app stopped being an Autopilot app). */
+    signingSecret?: string;
+    signingSecretHint?: string;
+};
+type RotateSigningSecretResponse = {
+    ref: string;
+    signingSecret: string;
+    signingSecretHint: string;
+};
 type ListApplicationsResponse = ListResponse<Application>;
 type EvaluateIntelligenceRequest = {
     intelligence: {
-        productRef: string;
+        /** Ignored: the agent's catalog id names the provider. */
+        productRef?: string;
+        /** A session agent with testCases. */
         config: Record<string, unknown>;
     };
 };
@@ -122,4 +174,4 @@ type CreateTestTokenResponse = {
     username: string;
     token: string;
 };
-export { Application, ApplicationType, CreateApplicationRequest, CreateTestTokenResponse, ListApplicationsRequest, ListApplicationsResponse, UpdateApplicationRequest, EvaluateIntelligenceRequest, EvaluateIntelligenceEvent, ScenarioEvaluationReport, StepEvaluationReport, ToolEvaluationReport, ExpectedTextType };
+export { AmdSettings, AppListener, AudioFilter, AudioFormat, CreateApplicationResponse, UpdateApplicationResponse, RecordingPolicy, RotateSigningSecretResponse, SessionAppFields, SpeechDefaults, Application, ApplicationType, CreateApplicationRequest, CreateTestTokenResponse, ListApplicationsRequest, ListApplicationsResponse, UpdateApplicationRequest, EvaluateIntelligenceRequest, EvaluateIntelligenceEvent, ScenarioEvaluationReport, StepEvaluationReport, ToolEvaluationReport, ExpectedTextType };

package/dist/applications.types.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExpectedTextType = exports.ApplicationType = void 0;
 var ApplicationType;
 (function (ApplicationType) {
-    ApplicationType["EXTERNAL"] = "EXTERNAL";
+    ApplicationType["STREAM"] = "STREAM";
     ApplicationType["AUTOPILOT"] = "AUTOPILOT";
 })(ApplicationType || (exports.ApplicationType = ApplicationType = {}));
 var ExpectedTextType;

package/dist/billing.types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/** Where credits came from: the plan, a top-up or the Trial. */
+type CreditSource = {
+    /** plan, topup or trial */
+    kind: string;
+    credits: number;
+    /** ISO 8601; empty when they don't expire */
+    expiresAt: string;
+};
+type BillingSummary = {
+    /** trial or payg */
+    plan: string;
+    /** active, past_due, closed, or ended (a Trial past its 30 days) */
+    status: string;
+    /** Credits; negative while in the overdraft */
+    balance: number;
+    /** How far below zero the balance may go, in credits */
+    overdraft: number;
+    sources: CreditSource[];
+    /** ISO 8601; empty on the Trial */
+    periodEnd: string;
+    autoRecharge: boolean;
+    rechargeThreshold: number;
+    rechargeAmount: number;
+};
+type UpdateAutoRechargeRequest = {
+    enabled: boolean;
+    /** Recharge when the balance falls below this many credits */
+    threshold: number;
+    /** Credits bought each time (at least the smallest top-up) */
+    amount: number;
+};
+type CreateTopUpRequest = {
+    /** Credits to buy (at least the smallest top-up); tax is added on top */
+    credits: number;
+};
+type CreatePortalSessionRequest = {
+    /** Where the Stripe Customer Portal sends the owner back to */
+    returnUrl: string;
+};
+type CreatePortalSessionResponse = {
+    url: string;
+};
+export { BillingSummary, CreateTopUpRequest, CreatePortalSessionRequest, CreatePortalSessionResponse, CreditSource, UpdateAutoRechargeRequest };

package/dist/billing.types.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Fonoster Cloud's billing (billing.proto), for the workspace owner. Amounts are credits
+// (1 credit = $0.01). There is no owner field: the account is always the caller's.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/calls.types.d.ts

@@ -62,6 +62,7 @@ type CallDetailRecord = {
     amdDetector?: string;
     amdLatencyMs?: number;
     amdCause?: string;
+    appRef?: string;
 };
 type ListCallsRequest = {
     after?: string;
@@ -70,6 +71,7 @@ type ListCallsRequest = {
     status?: CallStatus;
     from?: string;
     to?: string;
+    appRef?: string;
     pageSize?: number;
     pageToken?: string;
 };

package/dist/identity.types.d.ts

@@ -54,7 +54,10 @@ type CreateApiKeyResponse = {
 type UpdateUserRequest = {
     ref: string;
     name?: string;
+    /** A new password; requires currentPassword. */
     password?: string;
+    /** The account's current password, required to set a new one. */
+    currentPassword?: string;
     avatar?: string;
     phone?: string;
 };
@@ -77,7 +80,8 @@ type ApiKey = {
 };
 type SendResetPasswordCodeRequest = {
     username: string;
-    resetPasswordUrl: string;
+    /** Deprecated and ignored: Identity links to its configured reset page. */
+    resetPasswordUrl?: string;
 };
 type ResetPasswordRequest = {
     username: string;

package/dist/index.d.ts

@@ -28,3 +28,9 @@ export * from "./numbers.types";
 export * from "./secrets.types";
 export * from "./trunks.types";
 export * from "./workspaces.types";
+export * from "./providers.types";
+export * from "./webhooks.types";
+export * from "./records.types";
+export * from "./regions.types";
+export * from "./usage.types";
+export * from "./billing.types";

package/dist/index.js

@@ -44,3 +44,9 @@ __exportStar(require("./numbers.types"), exports);
 __exportStar(require("./secrets.types"), exports);
 __exportStar(require("./trunks.types"), exports);
 __exportStar(require("./workspaces.types"), exports);
+__exportStar(require("./providers.types"), exports);
+__exportStar(require("./webhooks.types"), exports);
+__exportStar(require("./records.types"), exports);
+__exportStar(require("./regions.types"), exports);
+__exportStar(require("./usage.types"), exports);
+__exportStar(require("./billing.types"), exports);

package/dist/providers.types.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/** A catalog entry visible to the workspace (add-provider-registry). */
+type CatalogItem = {
+    /** Catalog id, e.g. deepgram/nova-3; a provider's id has no slash. */
+    id: string;
+    kind: "provider" | "model" | "voice";
+    /** A display name; absent when the entry has none. */
+    label?: string;
+    state: "active" | "deprecated";
+    providerId: string;
+    /** Models: stt, tts or llm. */
+    type?: "stt" | "tts" | "llm" | "nc";
+    capabilities?: string[];
+    /** Providers: the adapter needs no key (fake, local models). */
+    keyless?: boolean;
+    languages?: string[];
+    features?: string[];
+    models?: string[];
+    gender?: string;
+    replacement?: string;
+    retireOn?: string;
+};
+type ListCatalogRequest = {
+    kind?: "provider" | "model" | "voice";
+    /** Models by type, or providers serving the capability (`nc`: noise cancelling). */
+    type?: "stt" | "tts" | "llm" | "nc";
+};
+type ListCatalogResponse = {
+    items: CatalogItem[];
+};
+/** A workspace's own vendor key; the key is only in its write-only Secret. */
+type ProviderKey = {
+    ref: string;
+    providerId: string;
+    secretRef: string;
+    createdAt: Date;
+    updatedAt: Date;
+};
+type SetProviderKeyRequest = {
+    providerId: string;
+    key: string;
+};
+type ListProviderKeysResponse = {
+    items: ProviderKey[];
+};
+/** Where a warned item is used in the workspace. */
+type WarningUse = {
+    kind: "app" | "agent";
+    ref: string;
+    name: string;
+    /** voice, ttsModel, sttModel or llm */
+    field: string;
+    /** For a TTS model: the voice the config uses with it. */
+    voice?: string;
+};
+/** A deprecated or retired catalog item the workspace uses (dashboard warnings). */
+type CatalogWarning = {
+    id: string;
+    kind: "provider" | "model" | "voice";
+    state: "deprecated" | "retired";
+    replacement?: string;
+    retireOn?: string;
+    usedBy: WarningUse[];
+    runtimeApps: string[];
+    runtimeSessions: number;
+    lastUsedAt?: string;
+};
+type ListWarningsResponse = {
+    items: CatalogWarning[];
+};
+export { CatalogWarning, ListWarningsResponse, WarningUse, CatalogItem, ListCatalogRequest, ListCatalogResponse, ListProviderKeysResponse, ProviderKey, SetProviderKeyRequest };

package/dist/providers.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/records.types.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/** A call record's index entry (add-call-record, /api/records). */
+type CallRecordSummary = {
+    callRef: string;
+    appRef: string | null;
+    from: string | null;
+    to: string | null;
+    direction: string | null;
+    /** completed, failed, erased, ... */
+    status: string;
+    endReason: string | null;
+    failureReason: string | null;
+    sipStatus: number | null;
+    /** Who answered, by AMD: human, voicemail, ivr, machine or unknown; null when AMD didn't run. */
+    amdStatus: string | null;
+    startedAt: string;
+    endedAt: string | null;
+    durationSeconds: number;
+    region: string;
+    version: number;
+    size: number;
+    parts: string[];
+};
+type ListCallRecordsRequest = {
+    /** ISO time bounds on startedAt. */
+    after?: string;
+    before?: string;
+    /** Matches the from or to number. */
+    number?: string;
+    appRef?: string;
+    /** inbound, outbound or internal. */
+    direction?: string;
+    status?: string;
+    pageSize?: number;
+    pageToken?: string;
+};
+type ListCallRecordsResponse = {
+    items: CallRecordSummary[];
+    nextPageToken?: string;
+};
+/** One version of a record: the vCon (redacted unless `original`) and its signature. */
+type CallRecordDetail = CallRecordSummary & {
+    currentVersion: number;
+    redacted: boolean;
+    vcon: Record<string, unknown>;
+    jws: unknown;
+};
+type CallRecordAuditEntry = {
+    action: string;
+    part: string;
+    reason: string;
+    actor: string;
+    version: number;
+    at: string;
+};
+type RetentionPolicy = {
+    part: string;
+    days: number | null;
+};
+export { CallRecordAuditEntry, CallRecordDetail, CallRecordSummary, ListCallRecordsRequest, ListCallRecordsResponse, RetentionPolicy };

package/dist/records.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/regions.types.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/** Regions (add-private-regions). */
+type RegionStatus = "waiting" | "connected" | "degraded" | "offline" | "unsupported";
+type RegionKind = "public" | "private";
+/** A region in a list (`GET /api/regions`): offered public regions and the caller's own. */
+type RegionSummary = {
+    /** Absent for a configured public region. */
+    ref?: string;
+    id: string;
+    /** Same as displayName. */
+    name: string;
+    displayName: string;
+    kind: RegionKind;
+    default: boolean;
+    status: RegionStatus;
+    /** Same as status. */
+    state: RegionStatus;
+    sipDomain?: string;
+    /** The caller's private regions: how many workspaces use it. */
+    workspaces?: number;
+    published?: boolean;
+};
+/** @deprecated use RegionSummary */
+type PublicRegion = RegionSummary;
+type ListRegionsResponse = {
+    items: RegionSummary[];
+};
+type RegionSecret = {
+    name: string;
+    usedBy: string[];
+    set: boolean;
+};
+type SipTransport = "udp" | "tcp" | "tls" | "ws" | "wss";
+/** Where carriers and softphones reach a region (contract §3 `region.R.endpoints`, §3a). */
+type RegionEndpoints = {
+    sip: {
+        host: string;
+        port: number;
+        transport: SipTransport;
+    }[];
+    /** Public addresses carriers must allowlist for signaling. */
+    signalingAddresses: string[];
+    /** Public addresses media (RTP) comes from. */
+    mediaAddresses: string[];
+    rtpPorts?: {
+        min: number;
+        max: number;
+    };
+    /** The region's SIP domain (PR-16): workspaces get subdomains of it. */
+    sipDomain?: string;
+    updatedAt?: string;
+};
+type RegionWorkspace = {
+    ref: string;
+    accessKeyId: string;
+    name: string;
+    /** The workspace's SIP domain in this region (`<label>.<sipDomain>`). */
+    domain?: string;
+};
+/** A region and its status (contract §0 `Region`). */
+type Region = {
+    ref: string;
+    id: string;
+    kind: RegionKind;
+    name: string;
+    displayName: string;
+    default?: boolean;
+    sipDomain?: string;
+    ownerRef?: string;
+    published?: boolean;
+    status: RegionStatus;
+    /** Same as status (alias). */
+    state: RegionStatus;
+    reason?: string;
+    unsupportedReason?: string;
+    requiredVersion?: string;
+    version?: string;
+    lastHeartbeatAt?: string;
+    /** Same as lastHeartbeatAt. */
+    lastSeenAt?: string;
+    enrolledAt?: string;
+    components?: {
+        roomrNodes: number;
+        appbridges: number;
+        autopilot: boolean;
+    };
+    roomrNodes?: number;
+    appbridges?: number;
+    activeCalls?: number;
+    configVersion?: number;
+    /** Owner views: the workspaces the region serves. */
+    workspaces?: RegionWorkspace[];
+    /** `getRegion()` of the current workspace: its SIP domain in the region. */
+    workspaceDomain?: string;
+    secretsNeeded?: string[];
+    secretsSet?: string[];
+    secrets: RegionSecret[];
+    /** Connection details; absent until a region's cell reports them. */
+    endpoints?: RegionEndpoints;
+    /** Private regions on the cloud: the flat monthly fee (PR-11); null when billing is off. */
+    monthlyFeeCents?: number | null;
+    /** Private regions: minutes reported this calendar month (UTC); shown, not billed. */
+    minutesThisMonth?: number;
+};
+type CreateRegionRequest = {
+    /** 3-32 lowercase letters, digits, hyphens; starts with a letter; never changes (PR-18). */
+    id: string;
+    displayName: string;
+    /** Your SIP domain (PR-16), e.g. sip.acme.com; point *.sip.acme.com at the region. */
+    sipDomain: string;
+};
+/** A one-time enrollment token (shown once); `enrollmentToken` is the same value. */
+type RegionEnrollmentToken = {
+    token: string;
+    enrollmentToken: string;
+    expiresAt: string;
+};
+type CreateRegionResponse = RegionEnrollmentToken & {
+    ref: string;
+    id: string;
+};
+export { CreateRegionRequest, CreateRegionResponse, ListRegionsResponse, RegionKind, RegionSummary, RegionWorkspace, PublicRegion, Region, RegionEndpoints, RegionEnrollmentToken, RegionSecret, RegionStatus, SipTransport };

package/dist/regions.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/usage.types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/** A dimension usage totals can be grouped by (usage.proto). */
+type UsageGroupBy = "day" | "workspace" | "meter" | "provider" | "model" | "key_source" | "origin";
+type GetUsageRequest = {
+    /** YYYY-MM-DD (UTC), inclusive. */
+    fromDay: string;
+    /** YYYY-MM-DD (UTC), inclusive. */
+    toDay: string;
+    /** Totals are always split by meter. */
+    groupBy?: UsageGroupBy[];
+    /** Owners only: every workspace the caller owns. */
+    allOwned?: boolean;
+};
+/** One usage total: quantities only, never money. Unrequested dimensions are empty. */
+type UsageRow = {
+    day: string;
+    workspaceRef: string;
+    meter: string;
+    /** second, character, token, count or byte */
+    unit: string;
+    provider: string;
+    model: string;
+    /** platform or workspace; empty for meters that call no vendor */
+    keySource: string;
+    /** call, browser_test, eval or api */
+    origin: string;
+    quantity: number;
+};
+type GetUsageResponse = {
+    rows: UsageRow[];
+};
+export { GetUsageRequest, GetUsageResponse, UsageGroupBy, UsageRow };

package/dist/usage.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/webhooks.types.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { ListRequest, ListResponse } from "./common";
+/** A workspace webhook endpoint (add-workspace-webhooks). */
+type Webhook = {
+    ref: string;
+    url: string;
+    events: string[];
+    /** The last characters of the current secret. */
+    secretHint: string;
+    /** Until when the previous secret still verifies (after a rotation). */
+    previousSecretUntil?: Date;
+    createdAt: Date;
+    updatedAt: Date;
+};
+type CreateWebhookRequest = {
+    url: string;
+    events: string[];
+};
+type CreateWebhookResponse = {
+    ref: string;
+    /** Shown only here and on rotation. */
+    secret: string;
+};
+type UpdateWebhookRequest = {
+    ref: string;
+    url?: string;
+    events?: string[];
+};
+type ListWebhooksRequest = ListRequest;
+type ListWebhooksResponse = ListResponse<Webhook>;
+type RotateWebhookSecretResponse = {
+    ref: string;
+    secret: string;
+    previousSecretUntil: Date;
+};
+type WebhookDelivery = {
+    ref: string;
+    webhookRef: string;
+    eventId: string;
+    eventType: string;
+    status: "pending" | "succeeded" | "failed";
+    attempts: number;
+    /** HTTP status of the last attempt (0: no response). */
+    lastStatus?: number;
+    lastAttemptAt?: Date;
+    nextAttemptAt?: Date;
+    createdAt: Date;
+};
+type ListWebhookDeliveriesRequest = {
+    webhookRef?: string;
+    pageSize?: number;
+};
+type ListWebhookDeliveriesResponse = {
+    items: WebhookDelivery[];
+};
+export { CreateWebhookRequest, CreateWebhookResponse, ListWebhookDeliveriesRequest, ListWebhookDeliveriesResponse, ListWebhooksRequest, ListWebhooksResponse, RotateWebhookSecretResponse, UpdateWebhookRequest, Webhook, WebhookDelivery };

package/dist/webhooks.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/workspaces.types.d.ts

@@ -34,6 +34,8 @@ type Workspace = {
     accessKeyId: string;
     createdAt: Date;
     updatedAt: Date;
+    /** A public region id (`default`, `us-east-1`) or a private region ref (`rg_…`). Immutable. */
+    region?: string;
     owner?: {
         ref: string;
         name: string;
@@ -42,6 +44,15 @@ type Workspace = {
 };
 type CreateWorkspaceRequest = {
     name: string;
+    /**
+     * An offered public region id (default `default`) or one of your private regions (id or ref),
+     * created first with `sdk.regions.createRegion`. Fixed for life.
+     */
+    region?: string;
+};
+type CreateWorkspaceResponse = {
+    ref: string;
+    region?: string;
 };
 type UpdateWorkspaceRequest = {
     ref: string;
@@ -70,4 +81,4 @@ type ResendWorkspaceMembershipInvitationRequest = {
 type ResendWorkspaceMembershipInvitationResponse = {
     userRef: string;
 };
-export { CreateWorkspaceRequest, InviteUserToWorkspaceRequest, InviteUserToWorkspaceResponse, ListWorkspacesResponse, RemoveUserFromWorkspaceRequest, RemoveUserFromWorkspaceResponse, ResendWorkspaceMembershipInvitationRequest, ResendWorkspaceMembershipInvitationResponse, UpdateWorkspaceRequest, Workspace, WorkspaceMemberStatus, Role };
+export { CreateWorkspaceResponse, CreateWorkspaceRequest, InviteUserToWorkspaceRequest, InviteUserToWorkspaceResponse, ListWorkspacesResponse, RemoveUserFromWorkspaceRequest, RemoveUserFromWorkspaceResponse, ResendWorkspaceMembershipInvitationRequest, ResendWorkspaceMembershipInvitationResponse, UpdateWorkspaceRequest, Workspace, WorkspaceMemberStatus, Role };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fonoster/types",
-  "version": "0.27.0",
+  "version": "0.31.0",
   "description": "Common types for Fonoster projects",
   "author": "Pedro Sanders <psanders@fonoster.com>",
   "homepage": "https://github.com/fonoster/fonoster#readme",
@@ -13,8 +13,7 @@
   },
   "scripts": {
     "prebuild": "rimraf ./dist tsconfig.tsbuildinfo",
-    "build": "tsc -b tsconfig.json",
-    "clean": "rimraf ./dist node_modules tsconfig.tsbuildinfo"
+    "build": "tsc -b tsconfig.json"
   },
   "files": [
     "dist"
@@ -29,5 +28,5 @@
   "bugs": {
     "url": "https://github.com/fonoster/fonoster/issues"
   },
-  "gitHead": "1191b34677b51a36000177887ff82303ef2693e1"
+  "gitHead": "f0a5102dddeea0f70f659234108805bc10690f2e"
 }