@lessly/sdk-app 97.3.0 → 97.5.0

package/dist/_types/gen/types.gen.d.ts

@@ -104970,6 +104970,332 @@ export interface OrganizationYoutubeInstallInput {
 export interface OrganizationYoutubeInstallOutput {
     url: string;
 }
+export interface PlaygroundAnalyticsOverviewInput {
+    /**
+     * Max records per entity in recent[]; omit for the endpoint default
+     */
+    limit?: number;
+}
+export interface PlaygroundAnalyticsOverviewOutput {
+    ok: boolean;
+    minted: boolean;
+    overview?: unknown;
+    http_status: number;
+}
+export interface PlaygroundBillingEntitlementsInput {
+}
+export interface PlaygroundBillingEntitlementsOutput {
+    ok: boolean;
+    minted: boolean;
+    http_status: number;
+    entitlements?: unknown;
+}
+export interface PlaygroundBillingRecordUsageInput {
+    /**
+     * Quantity of events to record against playground-events (SUM); defaults to 1
+     */
+    value?: number;
+}
+export interface PlaygroundBillingRecordUsageOutput {
+    minted: boolean;
+    accepted: (number | null);
+    recorded: boolean;
+    duplicates: (number | null);
+    http_status: number;
+}
+export interface PlaygroundClickupCreateTaskInput {
+    /**
+     * Task title; defaults to a fixture label
+     */
+    name?: string;
+    /**
+     * ClickUp list id; falls back to CLICKUP_TEST_LIST_ID
+     */
+    listId?: string;
+}
+export interface PlaygroundClickupCreateTaskOutput {
+    minted: boolean;
+    task_id: (string | null);
+    list_status: number;
+    vend_status: number;
+    clickup_status: number;
+    installation_count: number;
+}
+export interface PlaygroundClickupGetLastWebhookInput {
+}
+export type PlaygroundClickupGetLastWebhookOutput = ({
+    payload: string;
+    event_id: string;
+    provider: string;
+    verified: boolean;
+    product_id: string;
+    occurred_at: string;
+    connector_id: string;
+    clickup_event: (string | null);
+    receipt_count: number;
+} | {
+    found: false;
+});
+export interface PlaygroundClickupGetOverviewInput {
+}
+export interface PlaygroundClickupGetOverviewOutput {
+    team: ({
+        teamId: string;
+        teamName: string;
+    } | null);
+    lists: PlaygroundClickupGetOverviewOutputItems[];
+    tasks: {
+        id: string;
+        name: string;
+        status: (string | null);
+    }[];
+    minted: boolean;
+    spaces: PlaygroundClickupGetOverviewOutputItems[];
+    list_status: number;
+    vend_status: number;
+    lists_status: number;
+    tasks_status: number;
+    spaces_status: number;
+    folders_status: number;
+    installation_count: number;
+}
+export interface PlaygroundClickupGetOverviewOutputItems {
+    id: string;
+    name: string;
+}
+export interface PlaygroundEchoPingInput {
+    /**
+     * The text to echo back, 1–1024 characters
+     */
+    message: string;
+}
+export interface PlaygroundEchoPingOutput {
+    /**
+     * The message exactly as it was received
+     */
+    message: string;
+    /**
+     * The product the call was resolved to
+     */
+    productId: string;
+    /**
+     * ISO-8601 instant (UTC) at which the call reached the service
+     */
+    receivedAt: string;
+}
+export interface PlaygroundGdriveGetLastChangeInput {
+}
+export type PlaygroundGdriveGetLastChangeOutput = ({
+    file_id: string;
+    removed: boolean;
+    file_name: (string | null);
+    mime_type: (string | null);
+    product_id: string;
+    occurred_at: string;
+    connector_id: string;
+    resource_state: string;
+} | {
+    found: false;
+});
+export interface PlaygroundGdriveReadFileInput {
+    /**
+     * Drive file id; falls back to GDRIVE_TEST_FILE_ID, then the first picked file
+     */
+    fileId?: string;
+}
+export interface PlaygroundGdriveReadFileOutput {
+    minted: boolean;
+    file_id: (string | null);
+    file_name: (string | null);
+    mime_type: (string | null);
+    file_count: number;
+    get_status: number;
+    list_status: number;
+    vend_status: number;
+    content_bytes: (number | null);
+}
+export interface PlaygroundGoogleadsReadCustomerInput {
+}
+export interface PlaygroundGoogleadsReadCustomerOutput {
+    minted: boolean;
+    vended: boolean;
+    customer_id: (string | null);
+    vend_status: number;
+    result_count: number;
+    search_status: number;
+    login_customer_id: (string | null);
+}
+export interface PlaygroundLifecycleGetStateInput {
+}
+export interface PlaygroundLifecycleGetStateOutput {
+    blocked: boolean;
+    archived: boolean;
+    productId: string;
+    lastBlockTransition: ({
+        eventId: string;
+        eventName: string;
+        productId: string;
+        occurredAt: string;
+        recordedAt: string;
+        receiptCount: number;
+        organizationId: string;
+        cascadedFromOrg: boolean;
+    } | null);
+    lastArchiveTransition: ({
+        eventId: string;
+        eventName: string;
+        productId: string;
+        occurredAt: string;
+        recordedAt: string;
+        receiptCount: number;
+        organizationId: string;
+        cascadedFromOrg: boolean;
+    } | null);
+}
+export interface PlaygroundLifecycleListEventsInput {
+}
+export type PlaygroundLifecycleListEventsOutput = {
+    eventId: string;
+    eventName: string;
+    productId: string;
+    occurredAt: string;
+    recordedAt: string;
+    receiptCount: number;
+    organizationId: string;
+    cascadedFromOrg: boolean;
+}[];
+export interface PlaygroundWebhookGetLastInput {
+}
+export type PlaygroundWebhookGetLastOutput = ({
+    payload?: unknown;
+    event_id: string;
+    provider: string;
+    verified: boolean;
+    product_id: string;
+    occurred_at: string;
+    connector_id: string;
+    delivery_count: number;
+} | {
+    found: false;
+});
+export interface PlaygroundWorkflowEchoInput {
+    /**
+     * The text to store, 1–1024 characters
+     */
+    note: string;
+    /**
+     * Optional labels stored alongside the note, at most 20
+     *
+     * @maxItems 20
+     */
+    tags?: [] | [string] | [string, string] | [string, string, string] | [string, string, string, string] | [string, string, string, string, string] | [string, string, string, string, string, string] | [string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string];
+}
+export interface PlaygroundWorkflowEchoOutput {
+    /**
+     * Identifier of the stored echo
+     */
+    id: string;
+    /**
+     * The note exactly as it was received
+     */
+    note: string;
+    /**
+     * The tags exactly as they were received
+     */
+    tags: string[];
+    /**
+     * Correlation id for this echo. The playground/workflow.echoed event published about two seconds later repeats it, which is how a composer matches the completion back to this step.
+     */
+    echo_id: string;
+    /**
+     * ISO-8601 instant (UTC) at which the echo was stored
+     */
+    received_at: string;
+}
+export interface PlaygroundWorkflowEchoListInput {
+}
+export type PlaygroundWorkflowEchoListOutput = {
+    /**
+     * Identifier of the stored echo
+     */
+    id: string;
+    /**
+     * The note exactly as it was received
+     */
+    note: string;
+    /**
+     * The tags exactly as they were received
+     */
+    tags: string[];
+    /**
+     * ISO-8601 instant (UTC) at which the echo was stored
+     */
+    received_at: string;
+}[];
+export interface PlaygroundWorkflowPingInput {
+    /**
+     * Class of ping, echoed on the emitted event and filterable on the trigger. Defaults to 'manual'.
+     */
+    kind?: string;
+}
+export interface PlaygroundWorkflowPingOutput {
+    /**
+     * Correlation id for this ping. The emitted playground/workflow.ping event repeats it, which is how a composer matches the event back to this step.
+     */
+    id: string;
+    /**
+     * The name of the event that was published
+     */
+    event: string;
+}
+export interface PlaygroundWorkflowSubjectsListInput {
+    /**
+     * How many subjects to return, 1–100. Defaults to 25.
+     */
+    limit?: number;
+    /**
+     * The next_cursor of the previous page. Opaque — pass it back unchanged. Omit for the first page.
+     */
+    cursor?: string;
+    /**
+     * ISO-8601 UTC instant. Return only subjects whose last_activity_at is AT OR AFTER this — the opposite question, the recently active population. Omit for no lower bound.
+     */
+    last_activity_after?: string;
+    /**
+     * ISO-8601 UTC instant. Return only subjects whose last_activity_at is AT OR BEFORE this — the "inactive for N days" question: pass now minus N days. Omit for no upper bound.
+     */
+    last_activity_before?: string;
+}
+export interface PlaygroundWorkflowSubjectsListOutput {
+    /**
+     * This page of subjects, most recently active first
+     */
+    items: {
+        /**
+         * Stable identifier for the subject. This is the field a batch trigger keys on, so a subject already served in an earlier run is skipped rather than served twice.
+         */
+        subject_key: string;
+        /**
+         * Human-readable name of the subject
+         */
+        display_name: string;
+        /**
+         * ISO-8601 instant (UTC) of the subject last activity
+         */
+        last_activity_at: string;
+    }[];
+    /**
+     * Whether another page follows. False and a null next_cursor both mark the last page, so a consumer that loops on either terminates.
+     */
+    has_more: boolean;
+    /**
+     * Pass back as `cursor` to fetch the next page; null on the last page. Always null when has_more is false.
+     */
+    next_cursor: (string | null);
+}
+export interface PlaygroundWsEchoInput {
+}
+export type PlaygroundWsEchoOutput = unknown;
 export interface RealtimeArchiveExportInput {
     /**
      * Only entries with ts <= to_ts (epoch ms)

package/dist/_types/index.d.ts

@@ -1,7 +1,8 @@
 export { createLesslyApp } from './runtime/createLesslyApp.js';
 export type { LesslyClientBase } from './runtime/createLesslyApp.js';
 export { connectStream } from './runtime/connectStream.js';
-export { LesslyApiError, isAccessDenied, isEntitlementError, upgradeUrl } from './runtime/errors.js';
+export { LesslyApiError, isAccessDenied, accessDenialKind, isEntitlementError, upgradeUrl } from './runtime/errors.js';
+export type { AccessDenialKind } from './runtime/errors.js';
 export { accessReason } from './runtime/access-reason.js';
 export { platformApiBaseUrl } from './runtime/platform-base-url.js';
 export { operations } from './runtime/operations.js';

package/dist/_types/runtime/errors.d.ts

@@ -1,14 +1,18 @@
+export type AccessDenialKind = 'role_denied' | 'no_tool_permission' | 'operation_uncatalogued';
 export declare class LesslyApiError extends Error {
     readonly status: number;
     readonly code: string | null;
     readonly body: unknown;
-    /** True iff this is the gateway refusing the call over the caller's access. See ACCESS_DENIED_CODES. */
+    /** True for the three neutral gateway 403 refusals. See `isAccessDenied`. */
     readonly accessDenied: boolean;
     constructor(status: number, code: string | null, message: string, body: unknown);
 }
 export declare function parseErrorBody(body: unknown, status: number): LesslyApiError;
 /**
- * True iff `err` is the gateway refusing a call over the caller's access.
+ * True for the gateway's `role_denied`, `no_tool_permission`, and `operation_uncatalogued` 403s.
+ * The first two are permission decisions; `operation_uncatalogued` is a catalog/rollout state.
+ * Render all three as the same neutral state. Use `accessDenialKind` only when diagnostics need
+ * to distinguish the catalog case.
  *
  * Deliberately structural after the `instanceof` fast path: an App is composed into the shell
  * through Module Federation and `@lessly/sdk-app` is not a shared singleton, so the error a
@@ -16,6 +20,13 @@ export declare function parseErrorBody(body: unknown, status: number): LesslyApi
  * report false there and an App would render a red crash for an ordinary permission refusal.
  */
 export declare function isAccessDenied(err: unknown): boolean;
+/**
+ * The exact gateway access-refusal code at HTTP 403, or null for any other error.
+ * Structural like `isAccessDenied`, because an App may catch an error from another SDK copy.
+ * Use the kind for telemetry or developer-only catalog diagnostics, never to vary user-facing
+ * denial copy: `operation_uncatalogued` gets the same neutral state as the permission codes.
+ */
+export declare function accessDenialKind(err: unknown): AccessDenialKind | null;
 /**
  * True iff `err` is billing refusing the call over the organization's plan (trial cap reached,
  * a class closed on a trial, billing or budget paused). Inside the Workspace shell the shell