@lepsto/sdk-app 89.7.2 → 90.0.0

package/dist/playground/index.js

@@ -1,4 +1,4 @@
-import { wsBindings } from '../chunk-OSI6GWYM.js';
+import { wsBindings } from '../chunk-T3O56NBF.js';
 
 // src/gen/playground/queryOptions.gen.ts
 var playgroundAnalyticsOverviewQueryOptions = (sdk, input) => ({

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lepsto/sdk-app",
   "description": "The Lepsto SDK for App is a TypeScript SDK that provides runtime bindings and type-safe generated code for interacting with Lepsto Platform APIs and services. This package generates type definitions and client bindings from API catalogs, enabling developers to build applications that consume Lepsto platform services with full type safety and autocompletion.",
-  "version": "89.7.2",
+  "version": "90.0.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/lepsto/lepsto-sdk-app.git"
@@ -220,5 +220,5 @@
       }
     }
   },
-  "sdkContentHash": "sha256:63488b3b76be7383c6afaa2b34b0b104b16ab0b8b0c9a369a8d6c1759dd0c357"
+  "sdkContentHash": "sha256:681e6a1f4cc516c2a553ab21aa745074f4cfaf3c62617d9739ab6ac2ba0c5a96"
 }

package/src/gen/bindings.gen.ts

@@ -10349,6 +10349,18 @@ export const bindings: BindingsMap = {
             "in": "body",
             "name": "testUser"
           },
+          {
+            "in": "body",
+            "name": "kind"
+          },
+          {
+            "in": "body",
+            "name": "stage"
+          },
+          {
+            "in": "body",
+            "name": "tags"
+          },
           {
             "in": "body",
             "name": "requiresReset"
@@ -10399,6 +10411,14 @@ export const bindings: BindingsMap = {
             "in": "query",
             "name": "includeDeleted"
           },
+          {
+            "in": "query",
+            "name": "kind"
+          },
+          {
+            "in": "query",
+            "name": "includeContacts"
+          },
           {
             "in": "query",
             "name": "limit"
@@ -10487,6 +10507,22 @@ export const bindings: BindingsMap = {
             "in": "query",
             "name": "includeTestUsers"
           },
+          {
+            "in": "query",
+            "name": "kind"
+          },
+          {
+            "in": "query",
+            "name": "stage"
+          },
+          {
+            "in": "query",
+            "name": "tag"
+          },
+          {
+            "in": "query",
+            "name": "includeContacts"
+          },
           {
             "in": "query",
             "name": "limit"
@@ -10552,6 +10588,14 @@ export const bindings: BindingsMap = {
           {
             "in": "body",
             "name": "unsafeMetadata"
+          },
+          {
+            "in": "body",
+            "name": "stage"
+          },
+          {
+            "in": "body",
+            "name": "tags"
           }
         ],
         "path": "/users/users/:userId",

package/src/gen/types.gen.ts

@@ -115799,9 +115799,9 @@ export interface UsersApikeysCreateInput {
  */
 name: string
 /**
- * 'server' mints a SECRET key (usk_…) for the Product's backend — returned exactly once and stored hashed. 'publishable' mints a non-secret key (upk_…) that identifies this product in browser flows and stays readable.
+ * 'publishable' mints a non-secret key (upk_…) that identifies this product in browser flows and stays readable. It is the only key type: the secret server key (usk_…) is retired.
  */
-type: ("server" | "publishable")
+type: "publishable"
 }
 
 export interface UsersApikeysCreateOutput {
@@ -115818,15 +115818,15 @@ key: string
  */
 name: string
 /**
- * `server` for a secret backend key (usk_…), `publishable` for a browser-safe one (upk_…).
+ * `publishable` — a browser-safe key (upk_…). It is the only type.
  */
-type: ("server" | "publishable")
+type: "publishable"
 /**
- * The full value of a publishable key, which is not a secret. Null for a server key — that value exists in exactly one response, ever.
+ * The full value of the key, which is not a secret and stays readable.
  */
 value: (string | null)
 /**
- * `usk_`/`upk_` plus six characters — enough to recognise a key, never to use one.
+ * `upk_` plus six characters — enough to recognise a key, never to use one.
  */
 prefix: string
 /**
@@ -115856,15 +115856,15 @@ id: string
  */
 name: string
 /**
- * `server` for a secret backend key (usk_…), `publishable` for a browser-safe one (upk_…).
+ * `publishable` — a browser-safe key (upk_…). It is the only type.
  */
-type: ("server" | "publishable")
+type: "publishable"
 /**
- * The full value of a publishable key, which is not a secret. Null for a server key — that value exists in exactly one response, ever.
+ * The full value of the key, which is not a secret and stays readable.
  */
 value: (string | null)
 /**
- * `usk_`/`upk_` plus six characters — enough to recognise a key, never to use one.
+ * `upk_` plus six characters — enough to recognise a key, never to use one.
  */
 prefix: string
 /**
@@ -115892,15 +115892,15 @@ id: string
  */
 name: string
 /**
- * `server` for a secret backend key (usk_…), `publishable` for a browser-safe one (upk_…).
+ * `publishable` — a browser-safe key (upk_…). It is the only type.
  */
-type: ("server" | "publishable")
+type: "publishable"
 /**
- * The full value of a publishable key, which is not a secret. Null for a server key — that value exists in exactly one response, ever.
+ * The full value of the key, which is not a secret and stays readable.
  */
 value: (string | null)
 /**
- * `usk_`/`upk_` plus six characters — enough to recognise a key, never to use one.
+ * `upk_` plus six characters — enough to recognise a key, never to use one.
  */
 prefix: string
 /**
@@ -117678,7 +117678,7 @@ refreshReuseDetected: number
  */
 since: string
 /**
- * Point-in-time directory populations by DERIVED status — `user` has no status column, these are computed from `waitlisted` and the ban/delete/erase timestamps.
+ * Point-in-time directory populations by DERIVED status — `user` has no status column, these are computed from `kind`, `waitlisted` and the ban/delete/erase timestamps.
  */
 users: {
 /**
@@ -117686,7 +117686,7 @@ users: {
  */
 total: number
 /**
- * Full accounts: not waitlisted, not banned, not deleted, not erased.
+ * Full accounts: kind 'account', not waitlisted, not banned, not deleted, not erased.
  */
 active: number
 /**
@@ -117701,6 +117701,10 @@ erased: number
  * SOFT-deleted and still recoverable — not erased.
  */
 deleted: number
+/**
+ * People the Product knows who have no credential and have never signed in (kind 'contact'), excluding deleted and erased ones. Never part of `active`, and never billed as retained users.
+ */
+contacts: number
 /**
  * Waitlist signups with no credential yet.
  */
@@ -117767,10 +117771,22 @@ export interface UsersUsersBanOutput {
  * Id of this end user. Pass it to any users_users_* tool.
  */
 id: string
+/**
+ * What kind of person this row is: 'account' (can sign in) or 'contact' (known to the Product, no credential, never signed in). A contact is hidden from the default users_users_list view and is never counted as a retained user.
+ */
+kind: ("account" | "contact")
 /**
  * The user's display name. Null when nobody set one.
  */
 name: (string | null)
+/**
+ * Free labels on this person, stored trimmed, lowercased and de-duplicated.
+ */
+tags: string[]
+/**
+ * The relationship stage, in funnel order: new, contacted, replied, engaged, converted, lost. A real change publishes `users/user.stage-changed`.
+ */
+stage: ("new" | "contacted" | "replied" | "engaged" | "converted" | "lost")
 /**
  * When the user was banned (ISO 8601). Null while they are not banned.
  */
@@ -117874,6 +117890,10 @@ unsafeMetadata: {
 privateMetadata: {
 [k: string]: unknown
 }
+/**
+ * The user this person was merged INTO, when they were merged. Null for everybody else — follow it to find where their records went.
+ */
+mergedIntoUserId: (string | null)
 /**
  * Id of the primary identifier row. Null when there is no primary identifier.
  */
@@ -117885,10 +117905,22 @@ emailChangeLockedUntil: (string | null)
 }
 
 export interface UsersUsersCreateInput {
+/**
+ * What kind of person to create. 'account' (the default) can sign in. 'contact' is somebody the Product knows who has NO credential — a contact may not carry `password`, `waitlisted` or `requiresReset` (`contact_cannot_hold_credentials`), is hidden from the default users_users_list view, and is never counted as a retained user. A contact becomes an account only by proving an address, never by an operator setting this.
+ */
+kind?: ("account" | "contact")
 /**
  * The user's display name.
  */
 name?: string
+/**
+ * Free labels for this person. Trimmed, lowercased and de-duplicated on write; at most 32 of at most 64 characters each.
+ */
+tags?: string[]
+/**
+ * The relationship stage to start them at, in funnel order: new, contacted, replied, engaged, converted, lost. Default 'new'.
+ */
+stage?: ("new" | "contacted" | "replied" | "engaged" | "converted" | "lost")
 /**
  * URL of the user's avatar image.
  */
@@ -117989,10 +118021,22 @@ export interface UsersUsersCreateOutput {
  * Id of this end user. Pass it to any users_users_* tool.
  */
 id: string
+/**
+ * What kind of person this row is: 'account' (can sign in) or 'contact' (known to the Product, no credential, never signed in). A contact is hidden from the default users_users_list view and is never counted as a retained user.
+ */
+kind: ("account" | "contact")
 /**
  * The user's display name. Null when nobody set one.
  */
 name: (string | null)
+/**
+ * Free labels on this person, stored trimmed, lowercased and de-duplicated.
+ */
+tags: string[]
+/**
+ * The relationship stage, in funnel order: new, contacted, replied, engaged, converted, lost. A real change publishes `users/user.stage-changed`.
+ */
+stage: ("new" | "contacted" | "replied" | "engaged" | "converted" | "lost")
 /**
  * When the user was banned (ISO 8601). Null while they are not banned.
  */
@@ -118096,6 +118140,10 @@ unsafeMetadata: {
 privateMetadata: {
 [k: string]: unknown
 }
+/**
+ * The user this person was merged INTO, when they were merged. Null for everybody else — follow it to find where their records went.
+ */
+mergedIntoUserId: (string | null)
 /**
  * Id of the primary identifier row. Null when there is no primary identifier.
  */
@@ -118118,10 +118166,22 @@ export interface UsersUsersDeleteOutput {
  * Id of this end user. Pass it to any users_users_* tool.
  */
 id: string
+/**
+ * What kind of person this row is: 'account' (can sign in) or 'contact' (known to the Product, no credential, never signed in). A contact is hidden from the default users_users_list view and is never counted as a retained user.
+ */
+kind: ("account" | "contact")
 /**
  * The user's display name. Null when nobody set one.
  */
 name: (string | null)
+/**
+ * Free labels on this person, stored trimmed, lowercased and de-duplicated.
+ */
+tags: string[]
+/**
+ * The relationship stage, in funnel order: new, contacted, replied, engaged, converted, lost. A real change publishes `users/user.stage-changed`.
+ */
+stage: ("new" | "contacted" | "replied" | "engaged" | "converted" | "lost")
 /**
  * When the user was banned (ISO 8601). Null while they are not banned.
  */
@@ -118225,6 +118285,10 @@ unsafeMetadata: {
 privateMetadata: {
 [k: string]: unknown
 }
+/**
+ * The user this person was merged INTO, when they were merged. Null for everybody else — follow it to find where their records went.
+ */
+mergedIntoUserId: (string | null)
 /**
  * Id of the primary identifier row. Null when there is no primary identifier.
  */
@@ -118236,6 +118300,10 @@ emailChangeLockedUntil: (string | null)
 }
 
 export interface UsersUsersExportInput {
+/**
+ * Filter by kind: 'account' or 'contact'. Omit for accounts only, unless `includeContacts` is true.
+ */
+kind?: ("account" | "contact")
 /**
  * Rows per page, 1-500. Default 100.
  */
@@ -118256,6 +118324,10 @@ status?: ("active" | "banned" | "waitlisted")
  * Include soft-deleted users. Default false.
  */
 includeDeleted?: boolean
+/**
+ * Include CONTACTS alongside accounts, so one pass exports both. Default false — the same rule this export already applies to waitlist signups and test users.
+ */
+includeContacts?: boolean
 }
 
 export interface UsersUsersExportOutput {
@@ -118265,10 +118337,22 @@ users: {
  * Id of this end user. Pass it to any users_users_* tool.
  */
 id: string
+/**
+ * What kind of person this row is: 'account' (can sign in) or 'contact' (known to the Product, no credential, never signed in). A contact is hidden from the default users_users_list view and is never counted as a retained user.
+ */
+kind: ("account" | "contact")
 /**
  * The user's display name. Null when nobody set one.
  */
 name: (string | null)
+/**
+ * Free labels on this person, stored trimmed, lowercased and de-duplicated.
+ */
+tags: string[]
+/**
+ * The relationship stage, in funnel order: new, contacted, replied, engaged, converted, lost. A real change publishes `users/user.stage-changed`.
+ */
+stage: ("new" | "contacted" | "replied" | "engaged" | "converted" | "lost")
 /**
  * When the user was banned (ISO 8601). Null while they are not banned.
  */
@@ -118372,6 +118456,10 @@ unsafeMetadata: {
 privateMetadata: {
 [k: string]: unknown
 }
+/**
+ * The user this person was merged INTO, when they were merged. Null for everybody else — follow it to find where their records went.
+ */
+mergedIntoUserId: (string | null)
 /**
  * Id of the primary identifier row. Null when there is no primary identifier.
  */
@@ -118397,10 +118485,22 @@ export interface UsersUsersGetOutput {
  * Id of this end user. Pass it to any users_users_* tool.
  */
 id: string
+/**
+ * What kind of person this row is: 'account' (can sign in) or 'contact' (known to the Product, no credential, never signed in). A contact is hidden from the default users_users_list view and is never counted as a retained user.
+ */
+kind: ("account" | "contact")
 /**
  * The user's display name. Null when nobody set one.
  */
 name: (string | null)
+/**
+ * Free labels on this person, stored trimmed, lowercased and de-duplicated.
+ */
+tags: string[]
+/**
+ * The relationship stage, in funnel order: new, contacted, replied, engaged, converted, lost. A real change publishes `users/user.stage-changed`.
+ */
+stage: ("new" | "contacted" | "replied" | "engaged" | "converted" | "lost")
 /**
  * When the user was banned (ISO 8601). Null while they are not banned.
  */
@@ -118504,6 +118604,10 @@ unsafeMetadata: {
 privateMetadata: {
 [k: string]: unknown
 }
+/**
+ * The user this person was merged INTO, when they were merged. Null for everybody else — follow it to find where their records went.
+ */
+mergedIntoUserId: (string | null)
 /**
  * Id of the primary identifier row. Null when there is no primary identifier.
  */
@@ -118558,6 +118662,10 @@ userId: (string | null)
  * How many rows were passed over — an address already in the directory, typically.
  */
 skipped: number
+/**
+ * How many of the CREATED users were contacts (`kind: 'contact'`). A row that was skipped or failed is not counted.
+ */
+contacts: number
 /**
  * How many rows you submitted.
  */
@@ -118607,6 +118715,14 @@ expiresAt: string
 }
 
 export interface UsersUsersListInput {
+/**
+ * Return only people carrying this tag. ONE tag, matched against the stored (lowercased) value and ANDed with the other filters.
+ */
+tag?: string
+/**
+ * Filter by kind: 'account' or 'contact'. Passing 'contact' is how you list contacts — they are hidden otherwise. Omit for accounts only, unless `includeContacts` is true.
+ */
+kind?: ("account" | "contact")
 /**
  * Page size, 1-100. Default 25.
  */
@@ -118615,6 +118731,10 @@ limit?: number
  * Case-insensitive substring match against the user's identifiers (email) and name.
  */
 query?: string
+/**
+ * Filter by relationship stage: new, contacted, replied, engaged, converted or lost. Omit for every stage.
+ */
+stage?: ("new" | "contacted" | "replied" | "engaged" | "converted" | "lost")
 /**
  * Opaque cursor from a previous response's `nextCursor`. Omit for the first page.
  */
@@ -118627,6 +118747,10 @@ status?: ("active" | "banned" | "waitlisted")
  * Include soft-deleted users. Default false — deleted users are hidden.
  */
 includeDeleted?: boolean
+/**
+ * Include CONTACTS. Default false: a contact has no credential and has never signed in, so it is not part of the directory an operator browses — the same rule waitlist signups and test users follow. Use `kind: "contact"` to see only them.
+ */
+includeContacts?: boolean
 /**
  * Include TEST USERS. Default false: a test user is a fixture, not a customer — it is excluded from metering and from this listing for the same reason. Ask for it explicitly when you are debugging the fixtures themselves.
  */
@@ -118646,10 +118770,22 @@ users: {
  * Id of this end user. Pass it to any users_users_* tool.
  */
 id: string
+/**
+ * What kind of person this row is: 'account' (can sign in) or 'contact' (known to the Product, no credential, never signed in). A contact is hidden from the default users_users_list view and is never counted as a retained user.
+ */
+kind: ("account" | "contact")
 /**
  * The user's display name. Null when nobody set one.
  */
 name: (string | null)
+/**
+ * Free labels on this person, stored trimmed, lowercased and de-duplicated.
+ */
+tags: string[]
+/**
+ * The relationship stage, in funnel order: new, contacted, replied, engaged, converted, lost. A real change publishes `users/user.stage-changed`.
+ */
+stage: ("new" | "contacted" | "replied" | "engaged" | "converted" | "lost")
 /**
  * When the user was banned (ISO 8601). Null while they are not banned.
  */
@@ -118753,6 +118889,10 @@ unsafeMetadata: {
 privateMetadata: {
 [k: string]: unknown
 }
+/**
+ * The user this person was merged INTO, when they were merged. Null for everybody else — follow it to find where their records went.
+ */
+mergedIntoUserId: (string | null)
 /**
  * Id of the primary identifier row. Null when there is no primary identifier.
  */
@@ -118806,10 +118946,22 @@ export interface UsersUsersUnbanOutput {
  * Id of this end user. Pass it to any users_users_* tool.
  */
 id: string
+/**
+ * What kind of person this row is: 'account' (can sign in) or 'contact' (known to the Product, no credential, never signed in). A contact is hidden from the default users_users_list view and is never counted as a retained user.
+ */
+kind: ("account" | "contact")
 /**
  * The user's display name. Null when nobody set one.
  */
 name: (string | null)
+/**
+ * Free labels on this person, stored trimmed, lowercased and de-duplicated.
+ */
+tags: string[]
+/**
+ * The relationship stage, in funnel order: new, contacted, replied, engaged, converted, lost. A real change publishes `users/user.stage-changed`.
+ */
+stage: ("new" | "contacted" | "replied" | "engaged" | "converted" | "lost")
 /**
  * When the user was banned (ISO 8601). Null while they are not banned.
  */
@@ -118913,6 +119065,10 @@ unsafeMetadata: {
 privateMetadata: {
 [k: string]: unknown
 }
+/**
+ * The user this person was merged INTO, when they were merged. Null for everybody else — follow it to find where their records went.
+ */
+mergedIntoUserId: (string | null)
 /**
  * Id of the primary identifier row. Null when there is no primary identifier.
  */
@@ -118928,6 +119084,14 @@ export interface UsersUsersUpdateInput {
  * The user's display name. Pass null to clear.
  */
 name?: (string | null)
+/**
+ * REPLACES the whole tag list — send every tag you want stored, not just the new ones. Trimmed, lowercased and de-duplicated on write.
+ */
+tags?: string[]
+/**
+ * Move the person to this relationship stage. A real change publishes `users/user.stage-changed`; a patch that changes ONLY the stage deliberately does not also publish `users/user.updated`, so a workflow that writes stages does not wake itself.
+ */
+stage?: ("new" | "contacted" | "replied" | "engaged" | "converted" | "lost")
 /**
  * The user to update.
  */
@@ -118975,10 +119139,22 @@ export interface UsersUsersUpdateOutput {
  * Id of this end user. Pass it to any users_users_* tool.
  */
 id: string
+/**
+ * What kind of person this row is: 'account' (can sign in) or 'contact' (known to the Product, no credential, never signed in). A contact is hidden from the default users_users_list view and is never counted as a retained user.
+ */
+kind: ("account" | "contact")
 /**
  * The user's display name. Null when nobody set one.
  */
 name: (string | null)
+/**
+ * Free labels on this person, stored trimmed, lowercased and de-duplicated.
+ */
+tags: string[]
+/**
+ * The relationship stage, in funnel order: new, contacted, replied, engaged, converted, lost. A real change publishes `users/user.stage-changed`.
+ */
+stage: ("new" | "contacted" | "replied" | "engaged" | "converted" | "lost")
 /**
  * When the user was banned (ISO 8601). Null while they are not banned.
  */
@@ -119082,6 +119258,10 @@ unsafeMetadata: {
 privateMetadata: {
 [k: string]: unknown
 }
+/**
+ * The user this person was merged INTO, when they were merged. Null for everybody else — follow it to find where their records went.
+ */
+mergedIntoUserId: (string | null)
 /**
  * Id of the primary identifier row. Null when there is no primary identifier.
  */