El SDK
El SDK de StudioCMS es una herramienta potente que te permite interactuar con StudioCMS programáticamente. Proporciona un conjunto de funciones y utilidades que te permiten gestionar y servir tu contenido utilizando nuestro propio cliente de base de datos interno Kysely^. También proporciona la base para el Panel de Control de StudioCMS, y está construido con Effect^.
Uso básico
Sección titulada «Uso básico»El SDK de StudioCMS está disponible como un módulo virtual en tu proyecto de Astro. Puedes importarlo y utilizarlo utilizando la siguiente sintaxis:
import { const SDKCore: Effect.Effect<{ AUTH: { verifyEmail: { get: (input: string) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; readonly token: string; } | undefined, DBCallbackFailure | DatabaseError, never>; create: (userId: string) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; readonly token: string; }, DBCallbackFailure | DatabaseError | GeneratorError, never>; delete: (input: string) => Effect.Effect<DeleteResult, DBCallbackFailure | DatabaseError, never>; }; oAuth: { create: (input: { readonly providerUserId: string; readonly provider: string; readonly userId: string; }) => Effect.Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; }, DBCallbackFailure | DatabaseError, never>; delete: (input: { readonly userId: string; readonly provider: string; }) => AuthDeletionResponse; searchByProviderId: (input: { readonly providerUserId: string; readonly userId: string; }) => Effect.Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; } | undefined, DBCallbackFailure | DatabaseError, never>; searchProvidersForId: (input: { readonly userId: string; readonly providerId: string; }) => Effect.Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; } | undefined, DBCallbackFailure | DatabaseError, never>; }; permission: { currentStatus: (input: string) => Effect.Effect<{ readonly user: string; readonly rank: "owner" | "admin" | "editor" | "visitor" | "unknown"; } | undefined, DBCallbackFailure | DatabaseError, never>; }; session: { create: (input: { readonly id: string; readonly userId: string; readonly expiresAt: string; }) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; }, DBCallbackFailure | DatabaseError, never>; getById: (input: string) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; } | undefined, DBCallbackFailure | DatabaseError, never>; sessionWithUser: (sessionId: string) => Effect.Effect<{ session: { readonly id: string; readonly userId: string; readonly expiresAt: Date; }; user: { readonly id: string; readonly url?: string | null | undefined; readonly name: string; readonly email?: string | null | undefined; readonly avatar?: string | null | undefined; readonly username: string; readonly password?: string | null | undefined; readonly updatedAt: Date; readonly createdAt: Date; readonly emailVerified: boolean; readonly notifications?: string | null | undefined; }; } | undefined, DBCallbackFailure | DatabaseError, never>; delete: (input: string) => AuthDeletionResponse; update: (input: { readonly id: string; readonly newDate: Date; }) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; }, DBCallbackFailure | DatabaseError, never>; }; user: { create: (userData: { readonly id: string; readonly url?: string | null | undefined; readonly name: string; readonly email?: string | null | undefined; readonly avatar?: string | null | undefined; readonly username: string; readonly password?: string | null | undefined; readonly updatedAt: string; readonly createdAt: string | undefined; readonly emailVerified: boolean; readonly notifications?: string | null | undefined; }, rank: "owner" | "admin" | "editor" ...
The new Effect-TS based SDK implementation that replaces the deprecated SDK.
This unified SDK merges the normal and cached SDK functionalities.
SDKCore, const SDKCoreJs: { AUTH: { verifyEmail: { get: (input: string) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; readonly token: string; } | undefined, DBCallbackFailure | DatabaseError, never>; create: (userId: string) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; readonly token: string; }, DBCallbackFailure | DatabaseError | GeneratorError, never>; delete: (input: string) => Effect.Effect<DeleteResult, DBCallbackFailure | DatabaseError, never>; }; oAuth: { create: (input: { readonly providerUserId: string; readonly provider: string; readonly userId: string; }) => Effect.Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; }, DBCallbackFailure | DatabaseError, never>; delete: (input: { readonly userId: string; readonly provider: string; }) => AuthDeletionResponse; searchByProviderId: (input: { readonly providerUserId: string; readonly userId: string; }) => Effect.Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; } | undefined, DBCallbackFailure | DatabaseError, never>; searchProvidersForId: (input: { readonly userId: string; readonly providerId: string; }) => Effect.Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; } | undefined, DBCallbackFailure | DatabaseError, never>; }; permission: { currentStatus: (input: string) => Effect.Effect<{ readonly user: string; readonly rank: "owner" | "admin" | "editor" | "visitor" | "unknown"; } | undefined, DBCallbackFailure | DatabaseError, never>; }; session: { create: (input: { readonly id: string; readonly userId: string; readonly expiresAt: string; }) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; }, DBCallbackFailure | DatabaseError, never>; getById: (input: string) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; } | undefined, DBCallbackFailure | DatabaseError, never>; sessionWithUser: (sessionId: string) => Effect.Effect<{ session: { readonly id: string; readonly userId: string; readonly expiresAt: Date; }; user: { readonly id: string; readonly url?: string | null | undefined; readonly name: string; readonly email?: string | null | undefined; readonly avatar?: string | null | undefined; readonly username: string; readonly password?: string | null | undefined; readonly updatedAt: Date; readonly createdAt: Date; readonly emailVerified: boolean; readonly notifications?: string | null | undefined; }; } | undefined, DBCallbackFailure | DatabaseError, never>; delete: (input: string) => AuthDeletionResponse; update: (input: { readonly id: string; readonly newDate: Date; }) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; }, DBCallbackFailure | DatabaseError, never>; }; user: { create: (userData: { readonly id: string; readonly url?: string | null | undefined; readonly name: string; readonly email?: string | null | undefined; readonly avatar?: string | null | undefined; readonly username: string; readonly password?: string | null | undefined; readonly updatedAt: string; readonly createdAt: string | undefined; readonly emailVerified: boolean; readonly notifications?: string | null | undefined; }, rank: "owner" | "admin" | "editor" | "visitor" | ...
VanillaJS Version of the SDKCore. Most internal functions will still contain Effects, you can use runSDK from the 'studiocms:sdk' to run these as normal async functions
SDKCoreJs, const runSDK: <A, E>(effect: Effect.Effect<A, E, never>) => Promise<A>
Utility function for running components of the SDKCoreJs
runSDK } from 'studiocms:sdk';import { import Effect
const pagesEffect: Effect.Effect<CombinedPageData[], DBClientInitializationError | SDKInitializationError | DBCallbackFailure | DatabaseError | ParseError | FolderTreeError | CollectorError | PaginateError, never>
import Effect
const gen: <YieldWrap<Effect.Effect<{ AUTH: { verifyEmail: { get: (input: string) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; readonly token: string; } | undefined, DBCallbackFailure | DatabaseError, never>; create: (userId: string) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; readonly token: string; }, DBCallbackFailure | DatabaseError | GeneratorError, never>; delete: (input: string) => Effect.Effect<DeleteResult, DBCallbackFailure | DatabaseError, never>; }; oAuth: { create: (input: { readonly providerUserId: string; readonly provider: string; readonly userId: string; }) => Effect.Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; }, DBCallbackFailure | DatabaseError, never>; delete: (input: { readonly userId: string; readonly provider: string; }) => AuthDeletionResponse; searchByProviderId: (input: { readonly providerUserId: string; readonly userId: string; }) => Effect.Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; } | undefined, DBCallbackFailure | DatabaseError, never>; searchProvidersForId: (input: { readonly userId: string; readonly providerId: string; }) => Effect.Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; } | undefined, DBCallbackFailure | DatabaseError, never>; }; permission: { currentStatus: (input: string) => Effect.Effect<{ readonly user: string; readonly rank: "owner" | "admin" | "editor" | "visitor" | "unknown"; } | undefined, DBCallbackFailure | DatabaseError, never>; }; session: { create: (input: { readonly id: string; readonly userId: string; readonly expiresAt: string; }) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; }, DBCallbackFailure | DatabaseError, never>; getById: (input: string) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; } | undefined, DBCallbackFailure | DatabaseError, never>; sessionWithUser: (sessionId: string) => Effect.Effect<{ session: { readonly id: string; readonly userId: string; readonly expiresAt: Date; }; user: { readonly id: string; readonly url?: string | null | undefined; readonly name: string; readonly email?: string | null | undefined; readonly avatar?: string | null | undefined; readonly username: string; readonly password?: string | null | undefined; readonly updatedAt: Date; readonly createdAt: Date; readonly emailVerified: boolean; readonly notifications?: string | null | undefined; }; } | undefined, DBCallbackFailure | DatabaseError, never>; delete: (input: string) => AuthDeletionResponse; update: (input: { readonly id: string; readonly newDate: Date; }) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; }, DBCallbackFailure | DatabaseError, never>; }; user: { create: (userData: { readonly id: string; readonly url?: string | null | undefined; readonly name: string; readonly email?: string | null | undefined; readonly avatar?: string | null | undefined; readonly username: string; readonly password?: string | null | undefined; readonly updatedAt: string; readonly createdAt: string | undefined; readonly emailVerified: boolean; readonly notifications?: string | null | undefined; }, rank: "owner" | "admin" ... (+1 overload)
Provides a way to write effectful code using generator functions, simplifying
control flow and error handling.
When to Use
Effect.gen allows you to write code that looks and behaves like synchronous
code, but it can handle asynchronous tasks, errors, and complex control flow
(like loops and conditions). It helps make asynchronous code more readable
and easier to manage.
The generator functions work similarly to async/await but with more
explicit control over the execution of effects. You can yield* values from
effects and return the final result at the end.
Example
import { Effect } from "effect"
const addServiceCharge = (amount: number) => amount + 1
const applyDiscount = ( total: number, discountRate: number): Effect.Effect<number, Error> => discountRate === 0 ? Effect.fail(new Error("Discount rate cannot be zero")) : Effect.succeed(total - (total * discountRate) / 100)
const fetchTransactionAmount = Effect.promise(() => Promise.resolve(100))
const fetchDiscountRate = Effect.promise(() => Promise.resolve(5))
export const program = Effect.gen(function* () { const transactionAmount = yield* fetchTransactionAmount const discountRate = yield* fetchDiscountRate const discountedAmount = yield* applyDiscount( transactionAmount, discountRate ) const finalAmount = addServiceCharge(discountedAmount) return `Final amount to charge: ${finalAmount}`})
const sdk: { AUTH: { verifyEmail: { get: (input: string) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; readonly token: string; } | undefined, DBCallbackFailure | DatabaseError, never>; create: (userId: string) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; readonly token: string; }, DBCallbackFailure | DatabaseError | GeneratorError, never>; delete: (input: string) => Effect.Effect<DeleteResult, DBCallbackFailure | DatabaseError, never>; }; oAuth: { create: (input: { readonly providerUserId: string; readonly provider: string; readonly userId: string; }) => Effect.Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; }, DBCallbackFailure | DatabaseError, never>; delete: (input: { readonly userId: string; readonly provider: string; }) => AuthDeletionResponse; searchByProviderId: (input: { readonly providerUserId: string; readonly userId: string; }) => Effect.Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; } | undefined, DBCallbackFailure | DatabaseError, never>; searchProvidersForId: (input: { readonly userId: string; readonly providerId: string; }) => Effect.Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; } | undefined, DBCallbackFailure | DatabaseError, never>; }; permission: { currentStatus: (input: string) => Effect.Effect<{ readonly user: string; readonly rank: "owner" | "admin" | "editor" | "visitor" | "unknown"; } | undefined, DBCallbackFailure | DatabaseError, never>; }; session: { create: (input: { readonly id: string; readonly userId: string; readonly expiresAt: string; }) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; }, DBCallbackFailure | DatabaseError, never>; getById: (input: string) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; } | undefined, DBCallbackFailure | DatabaseError, never>; sessionWithUser: (sessionId: string) => Effect.Effect<{ session: { readonly id: string; readonly userId: string; readonly expiresAt: Date; }; user: { readonly id: string; readonly url?: string | null | undefined; readonly name: string; readonly email?: string | null | undefined; readonly avatar?: string | null | undefined; readonly username: string; readonly password?: string | null | undefined; readonly updatedAt: Date; readonly createdAt: Date; readonly emailVerified: boolean; readonly notifications?: string | null | undefined; }; } | undefined, DBCallbackFailure | DatabaseError, never>; delete: (input: string) => AuthDeletionResponse; update: (input: { readonly id: string; readonly newDate: Date; }) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; }, DBCallbackFailure | DatabaseError, never>; }; user: { create: (userData: { readonly id: string; readonly url?: string | null | undefined; readonly name: string; readonly email?: string | null | undefined; readonly avatar?: string | null | undefined; readonly username: string; readonly password?: string | null | undefined; readonly updatedAt: string; readonly createdAt: string | undefined; readonly emailVerified: boolean; readonly notifications?: string | null | undefined; }, rank: "owner" | "admin" | "editor" | "visitor" | ...
const SDKCore: Effect.Effect<{ AUTH: { verifyEmail: { get: (input: string) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; readonly token: string; } | undefined, DBCallbackFailure | DatabaseError, never>; create: (userId: string) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; readonly token: string; }, DBCallbackFailure | DatabaseError | GeneratorError, never>; delete: (input: string) => Effect.Effect<DeleteResult, DBCallbackFailure | DatabaseError, never>; }; oAuth: { create: (input: { readonly providerUserId: string; readonly provider: string; readonly userId: string; }) => Effect.Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; }, DBCallbackFailure | DatabaseError, never>; delete: (input: { readonly userId: string; readonly provider: string; }) => AuthDeletionResponse; searchByProviderId: (input: { readonly providerUserId: string; readonly userId: string; }) => Effect.Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; } | undefined, DBCallbackFailure | DatabaseError, never>; searchProvidersForId: (input: { readonly userId: string; readonly providerId: string; }) => Effect.Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; } | undefined, DBCallbackFailure | DatabaseError, never>; }; permission: { currentStatus: (input: string) => Effect.Effect<{ readonly user: string; readonly rank: "owner" | "admin" | "editor" | "visitor" | "unknown"; } | undefined, DBCallbackFailure | DatabaseError, never>; }; session: { create: (input: { readonly id: string; readonly userId: string; readonly expiresAt: string; }) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; }, DBCallbackFailure | DatabaseError, never>; getById: (input: string) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; } | undefined, DBCallbackFailure | DatabaseError, never>; sessionWithUser: (sessionId: string) => Effect.Effect<{ session: { readonly id: string; readonly userId: string; readonly expiresAt: Date; }; user: { readonly id: string; readonly url?: string | null | undefined; readonly name: string; readonly email?: string | null | undefined; readonly avatar?: string | null | undefined; readonly username: string; readonly password?: string | null | undefined; readonly updatedAt: Date; readonly createdAt: Date; readonly emailVerified: boolean; readonly notifications?: string | null | undefined; }; } | undefined, DBCallbackFailure | DatabaseError, never>; delete: (input: string) => AuthDeletionResponse; update: (input: { readonly id: string; readonly newDate: Date; }) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; }, DBCallbackFailure | DatabaseError, never>; }; user: { create: (userData: { readonly id: string; readonly url?: string | null | undefined; readonly name: string; readonly email?: string | null | undefined; readonly avatar?: string | null | undefined; readonly username: string; readonly password?: string | null | undefined; readonly updatedAt: string; readonly createdAt: string | undefined; readonly emailVerified: boolean; readonly notifications?: string | null | undefined; }, rank: "owner" | "admin" | "editor" ...
The new Effect-TS based SDK implementation that replaces the deprecated SDK.
This unified SDK merges the normal and cached SDK functionalities.
SDKCore;
// luego haz algo con el SDK return yield* const sdk: { AUTH: { verifyEmail: { get: (input: string) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; readonly token: string; } | undefined, DBCallbackFailure | DatabaseError, never>; create: (userId: string) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; readonly token: string; }, DBCallbackFailure | DatabaseError | GeneratorError, never>; delete: (input: string) => Effect.Effect<DeleteResult, DBCallbackFailure | DatabaseError, never>; }; oAuth: { create: (input: { readonly providerUserId: string; readonly provider: string; readonly userId: string; }) => Effect.Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; }, DBCallbackFailure | DatabaseError, never>; delete: (input: { readonly userId: string; readonly provider: string; }) => AuthDeletionResponse; searchByProviderId: (input: { readonly providerUserId: string; readonly userId: string; }) => Effect.Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; } | undefined, DBCallbackFailure | DatabaseError, never>; searchProvidersForId: (input: { readonly userId: string; readonly providerId: string; }) => Effect.Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; } | undefined, DBCallbackFailure | DatabaseError, never>; }; permission: { currentStatus: (input: string) => Effect.Effect<{ readonly user: string; readonly rank: "owner" | "admin" | "editor" | "visitor" | "unknown"; } | undefined, DBCallbackFailure | DatabaseError, never>; }; session: { create: (input: { readonly id: string; readonly userId: string; readonly expiresAt: string; }) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; }, DBCallbackFailure | DatabaseError, never>; getById: (input: string) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; } | undefined, DBCallbackFailure | DatabaseError, never>; sessionWithUser: (sessionId: string) => Effect.Effect<{ session: { readonly id: string; readonly userId: string; readonly expiresAt: Date; }; user: { readonly id: string; readonly url?: string | null | undefined; readonly name: string; readonly email?: string | null | undefined; readonly avatar?: string | null | undefined; readonly username: string; readonly password?: string | null | undefined; readonly updatedAt: Date; readonly createdAt: Date; readonly emailVerified: boolean; readonly notifications?: string | null | undefined; }; } | undefined, DBCallbackFailure | DatabaseError, never>; delete: (input: string) => AuthDeletionResponse; update: (input: { readonly id: string; readonly newDate: Date; }) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; }, DBCallbackFailure | DatabaseError, never>; }; user: { create: (userData: { readonly id: string; readonly url?: string | null | undefined; readonly name: string; readonly email?: string | null | undefined; readonly avatar?: string | null | undefined; readonly username: string; readonly password?: string | null | undefined; readonly updatedAt: string; readonly createdAt: string | undefined; readonly emailVerified: boolean; readonly notifications?: string | null | undefined; }, rank: "owner" | "admin" | "editor" | "visitor" | ...
type GET: { permissionsLists: { owners: () => Effect.Effect<SingleRank[], UsersError | DBCallbackFailure | DatabaseError, never>; admins: () => Effect.Effect<SingleRank[], UsersError | DBCallbackFailure | DatabaseError, never>; editors: () => Effect.Effect<SingleRank[], UsersError | DBCallbackFailure | DatabaseError, never>; visitors: () => Effect.Effect<SingleRank[], UsersError | DBCallbackFailure | DatabaseError, never>; all: () => Effect.Effect<CombinedRank[], DBCallbackFailure | DatabaseError | UsersError, never>; }; ... 12 more ...; tags: { getAll: () => Effect.Effect<readonly { readonly id: number; readonly name: string; readonly description: string; readonly slug: string; readonly meta: { readonly [x: string]: unknown; }; }[], DBCallbackFailure | DatabaseError, never>; byId: (tagId: number) => Effect.Effect<{ readonly id: number; readonly name: string; readonly description: string; readonly slug: string; readonly meta: { readonly [x: string]: unknown; }; } | undefined, DBCallbackFailure | DatabaseError, never>; bySlug: (slug: string) => Effect.Effect<{ readonly id: number; readonly name: string; readonly description: string; readonly slug: string; readonly meta: { readonly [x: string]: unknown; }; } | undefined, DBCallbackFailure | DatabaseError, never>; };}
pages: (includeDrafts?: boolean, metaOnly?: false, paginate?: PaginateInput) => Effect.Effect<CombinedPageData[], ParseError | DBCallbackFailure | DatabaseError | FolderTreeError | CollectorError | PaginateError, never> (+1 overload)
const pagesResult1: CombinedPageData[]
runSDK<CombinedPageData[], DBClientInitializationError | SDKInitializationError | DBCallbackFailure | DatabaseError | ParseError | FolderTreeError | CollectorError | PaginateError>(effect: Effect.Effect<CombinedPageData[], DBClientInitializationError | SDKInitializationError | DBCallbackFailure | ... 4 more ... | PaginateError, never>): Promise<...>
Alias for runEffect, used to run SDK effects and convert them to plain JavaScript objects.
runSDK(const pagesEffect: Effect.Effect<CombinedPageData[], DBClientInitializationError | SDKInitializationError | DBCallbackFailure | DatabaseError | ParseError | FolderTreeError | CollectorError | PaginateError, never>
const pagesResult2: CombinedPageData[]
runSDK<CombinedPageData[], DBCallbackFailure | DatabaseError | ParseError | FolderTreeError | CollectorError | PaginateError>(effect: Effect.Effect<CombinedPageData[], DBCallbackFailure | DatabaseError | ParseError | FolderTreeError | CollectorError | PaginateError, never>): Promise<CombinedPageData[]>
Alias for runEffect, used to run SDK effects and convert them to plain JavaScript objects.
runSDK(const SDKCoreJs: { AUTH: { verifyEmail: { get: (input: string) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; readonly token: string; } | undefined, DBCallbackFailure | DatabaseError, never>; create: (userId: string) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; readonly token: string; }, DBCallbackFailure | DatabaseError | GeneratorError, never>; delete: (input: string) => Effect.Effect<DeleteResult, DBCallbackFailure | DatabaseError, never>; }; oAuth: { create: (input: { readonly providerUserId: string; readonly provider: string; readonly userId: string; }) => Effect.Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; }, DBCallbackFailure | DatabaseError, never>; delete: (input: { readonly userId: string; readonly provider: string; }) => AuthDeletionResponse; searchByProviderId: (input: { readonly providerUserId: string; readonly userId: string; }) => Effect.Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; } | undefined, DBCallbackFailure | DatabaseError, never>; searchProvidersForId: (input: { readonly userId: string; readonly providerId: string; }) => Effect.Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; } | undefined, DBCallbackFailure | DatabaseError, never>; }; permission: { currentStatus: (input: string) => Effect.Effect<{ readonly user: string; readonly rank: "owner" | "admin" | "editor" | "visitor" | "unknown"; } | undefined, DBCallbackFailure | DatabaseError, never>; }; session: { create: (input: { readonly id: string; readonly userId: string; readonly expiresAt: string; }) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; }, DBCallbackFailure | DatabaseError, never>; getById: (input: string) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; } | undefined, DBCallbackFailure | DatabaseError, never>; sessionWithUser: (sessionId: string) => Effect.Effect<{ session: { readonly id: string; readonly userId: string; readonly expiresAt: Date; }; user: { readonly id: string; readonly url?: string | null | undefined; readonly name: string; readonly email?: string | null | undefined; readonly avatar?: string | null | undefined; readonly username: string; readonly password?: string | null | undefined; readonly updatedAt: Date; readonly createdAt: Date; readonly emailVerified: boolean; readonly notifications?: string | null | undefined; }; } | undefined, DBCallbackFailure | DatabaseError, never>; delete: (input: string) => AuthDeletionResponse; update: (input: { readonly id: string; readonly newDate: Date; }) => Effect.Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; }, DBCallbackFailure | DatabaseError, never>; }; user: { create: (userData: { readonly id: string; readonly url?: string | null | undefined; readonly name: string; readonly email?: string | null | undefined; readonly avatar?: string | null | undefined; readonly username: string; readonly password?: string | null | undefined; readonly updatedAt: string; readonly createdAt: string | undefined; readonly emailVerified: boolean; readonly notifications?: string | null | undefined; }, rank: "owner" | "admin" | "editor" | "visitor" | ...
VanillaJS Version of the SDKCore. Most internal functions will still contain Effects, you can use runSDK from the 'studiocms:sdk' to run these as normal async functions
SDKCoreJs.type GET: { permissionsLists: { owners: () => Effect.Effect<SingleRank[], UsersError | DBCallbackFailure | DatabaseError, never>; admins: () => Effect.Effect<SingleRank[], UsersError | DBCallbackFailure | DatabaseError, never>; editors: () => Effect.Effect<SingleRank[], UsersError | DBCallbackFailure | DatabaseError, never>; visitors: () => Effect.Effect<SingleRank[], UsersError | DBCallbackFailure | DatabaseError, never>; all: () => Effect.Effect<CombinedRank[], DBCallbackFailure | DatabaseError | UsersError, never>; }; ... 12 more ...; tags: { getAll: () => Effect.Effect<readonly { readonly id: number; readonly name: string; readonly description: string; readonly slug: string; readonly meta: { readonly [x: string]: unknown; }; }[], DBCallbackFailure | DatabaseError, never>; byId: (tagId: number) => Effect.Effect<{ readonly id: number; readonly name: string; readonly description: string; readonly slug: string; readonly meta: { readonly [x: string]: unknown; }; } | undefined, DBCallbackFailure | DatabaseError, never>; bySlug: (slug: string) => Effect.Effect<{ readonly id: number; readonly name: string; readonly description: string; readonly slug: string; readonly meta: { readonly [x: string]: unknown; }; } | undefined, DBCallbackFailure | DatabaseError, never>; };}
pages: (includeDrafts?: boolean, metaOnly?: false, paginate?: PaginateInput) => Effect.Effect<CombinedPageData[], ParseError | DBCallbackFailure | DatabaseError | FolderTreeError | CollectorError | PaginateError, never> (+1 overload)
Utilidades disponibles
Sección titulada «Utilidades disponibles»A continuación se muestra una lista de las utilidades principales proporcionadas por el SDK de StudioCMS para interactuar con la base de datos.
import { const SDKCoreJs: { AUTH: { verifyEmail: { get: (input: string) => Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; readonly token: string; } | undefined, DBCallbackFailure | DatabaseError, never>; create: (userId: string) => Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; readonly token: string; }, DBCallbackFailure | DatabaseError | GeneratorError, never>; delete: (input: string) => Effect<DeleteResult, DBCallbackFailure | DatabaseError, never>; }; oAuth: { create: (input: { readonly providerUserId: string; readonly provider: string; readonly userId: string; }) => Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; }, DBCallbackFailure | DatabaseError, never>; delete: (input: { readonly userId: string; readonly provider: string; }) => AuthDeletionResponse; searchByProviderId: (input: { readonly providerUserId: string; readonly userId: string; }) => Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; } | undefined, DBCallbackFailure | DatabaseError, never>; searchProvidersForId: (input: { readonly userId: string; readonly providerId: string; }) => Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; } | undefined, DBCallbackFailure | DatabaseError, never>; }; permission: { currentStatus: (input: string) => Effect<{ readonly user: string; readonly rank: "owner" | "admin" | "editor" | "visitor" | "unknown"; } | undefined, DBCallbackFailure | DatabaseError, never>; }; session: { create: (input: { readonly id: string; readonly userId: string; readonly expiresAt: string; }) => Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; }, DBCallbackFailure | DatabaseError, never>; getById: (input: string) => Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; } | undefined, DBCallbackFailure | DatabaseError, never>; sessionWithUser: (sessionId: string) => Effect<{ session: { readonly id: string; readonly userId: string; readonly expiresAt: Date; }; user: { readonly id: string; readonly url?: string | null | undefined; readonly name: string; readonly email?: string | null | undefined; readonly avatar?: string | null | undefined; readonly username: string; readonly password?: string | null | undefined; readonly updatedAt: Date; readonly createdAt: Date; readonly emailVerified: boolean; readonly notifications?: string | null | undefined; }; } | undefined, DBCallbackFailure | DatabaseError, never>; delete: (input: string) => AuthDeletionResponse; update: (input: { readonly id: string; readonly newDate: Date; }) => Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; }, DBCallbackFailure | DatabaseError, never>; }; user: { create: (userData: { readonly id: string; readonly url?: string | null | undefined; readonly name: string; readonly email?: string | null | undefined; readonly avatar?: string | null | undefined; readonly username: string; readonly password?: string | null | undefined; readonly updatedAt: string; readonly createdAt: string | undefined; readonly emailVerified: boolean; readonly notifications?: string | null | undefined; }, rank: "owner" | "admin" | "editor" | "visitor" | "unknown") => Effect<{ readonly id: string; readonly ...
VanillaJS Version of the SDKCore. Most internal functions will still contain Effects, you can use runSDK from the 'studiocms:sdk' to run these as normal async functions
SDKCoreJs } from 'studiocms:sdk';
const { const dbService: DBClientInterface<{ readonly StudioCMSUsersTable: { readonly id: string; readonly name: string; readonly username: string; readonly updatedAt: ColumnType<string, string, string>; readonly createdAt: ColumnType<string, string | undefined, undefined>; readonly emailVerified: number; readonly url?: string | null | undefined; readonly email?: string | null | undefined; readonly avatar?: string | null | undefined; readonly password?: string | null | undefined; readonly notifications?: string | null | undefined; }; ... 14 more ...; readonly StudioCMSStorageManagerUrlMappings: { readonly url: string; readonly updatedAt: number; readonly createdAt: ColumnType<...>; readonly identifier: string; readonly isPermanent: ColumnType<...>; readonly expiresAt?: number | null | undefined; };}>
const cache: CacheService
const AUTH: { verifyEmail: { get: (input: string) => Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; readonly token: string; } | undefined, DBCallbackFailure | DatabaseError, never>; create: (userId: string) => Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; readonly token: string; }, DBCallbackFailure | DatabaseError | GeneratorError, never>; delete: (input: string) => Effect<DeleteResult, DBCallbackFailure | DatabaseError, never>; }; oAuth: { create: (input: { readonly providerUserId: string; readonly provider: string; readonly userId: string; }) => Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; }, DBCallbackFailure | DatabaseError, never>; delete: (input: { readonly userId: string; readonly provider: string; }) => AuthDeletionResponse; searchByProviderId: (input: { readonly providerUserId: string; readonly userId: string; }) => Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; } | undefined, DBCallbackFailure | DatabaseError, never>; searchProvidersForId: (input: { readonly userId: string; readonly providerId: string; }) => Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; } | undefined, DBCallbackFailure | DatabaseError, never>; }; permission: { currentStatus: (input: string) => Effect<{ readonly user: string; readonly rank: "owner" | "admin" | "editor" | "visitor" | "unknown"; } | undefined, DBCallbackFailure | DatabaseError, never>; }; session: { create: (input: { readonly id: string; readonly userId: string; readonly expiresAt: string; }) => Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; }, DBCallbackFailure | DatabaseError, never>; getById: (input: string) => Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; } | undefined, DBCallbackFailure | DatabaseError, never>; sessionWithUser: (sessionId: string) => Effect<{ session: { readonly id: string; readonly userId: string; readonly expiresAt: Date; }; user: { readonly id: string; readonly url?: string | null | undefined; readonly name: string; readonly email?: string | null | undefined; readonly avatar?: string | null | undefined; readonly username: string; readonly password?: string | null | undefined; readonly updatedAt: Date; readonly createdAt: Date; readonly emailVerified: boolean; readonly notifications?: string | null | undefined; }; } | undefined, DBCallbackFailure | DatabaseError, never>; delete: (input: string) => AuthDeletionResponse; update: (input: { readonly id: string; readonly newDate: Date; }) => Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; }, DBCallbackFailure | DatabaseError, never>; }; user: { create: (userData: { readonly id: string; readonly url?: string | null | undefined; readonly name: string; readonly email?: string | null | undefined; readonly avatar?: string | null | undefined; readonly username: string; readonly password?: string | null | undefined; readonly updatedAt: string; readonly createdAt: string | undefined; readonly emailVerified: boolean; readonly notifications?: string | null | undefined; }, rank: "owner" | "admin" | "editor" | "visitor" | "unknown") => Effect<{ readonly id: string; readonly url?: string | null | undefined; readonly name: string; readonly email?: string | null | undefined; readonly avatar?: string | null | undefined; readonly username: string; readonly password?: string | null | undefined; readonly updatedAt: Date; readonly createdAt: Date; readonly emailVerified: boolean; readonly notifications?: string | null | undefined ...
const CLEAR: { page: { byId: (id: string) => Effect<void, never, never>; }; pages: Effect<void, never, never>; latestVersion: Effect<void, never, never>; folderTree: Effect<void, never, never>; folderList: Effect<void, never, never>;}
const CONFIG: { siteConfig: { get: <T extends StudioCMSSiteConfig>() => Effect<DynamicConfigEntry<T> | undefined, UnknownException | DBCallbackFailure | DatabaseError, never>; update: (data: ConfigFinal<StudioCMSSiteConfig>) => Effect<DynamicConfigEntry<StudioCMSSiteConfig>, DBCallbackFailure | DatabaseError, never>; init: (data: ConfigFinal<StudioCMSSiteConfig>) => Effect<DynamicConfigEntry<StudioCMSSiteConfig>, DBCallbackFailure | DatabaseError, never>; }; mailerConfig: { get: () => Effect<DynamicConfigEntry<...> | undefined, DBCallbackFailure | DatabaseError, never>; update: (data: ConfigFinal<...>) => Effect<DynamicConfigEntry<...>, DBCallbackFailure | DatabaseError, never>; init: (data: ConfigFinal<...>) => Effect<DynamicConfigEntry<...>, DBCallbackFailure | DatabaseError, never>; }; notificationConfig: { get: () => Effect<DynamicConfigEntry<...> | undefined, DBCallbackFailure | DatabaseError, never>; update: (data: ConfigFinal<...>) => Effect<DynamicConfigEntry<...>, DBCallbackFailure | DatabaseError, never>; init: (data: ConfigFinal<...>) => Effect<DynamicConfigEntry<...>, DBCallbackFailure | DatabaseError, never>; }; templateConfig: { get: () => Effect<DynamicConfigEntry<...> | undefined, DBCallbackFailure | DatabaseError, never>; update: (data: ConfigFinal<...>) => Effect<DynamicConfigEntry<...>, DBCallbackFailure | DatabaseError | DeepmergeError, never>; init: (data: ConfigFinal<...>) => Effect<DynamicConfigEntry<...>, DBCallbackFailure | DatabaseError, never>; };}
const DELETE: { page: (id: string) => Effect<{ status: "success" | "error"; message: string; }, never, never>; pageContent: (id: string) => Effect<{ status: "success" | "error"; message: string; }, never, never>; pageContentLang: (id: string, lang: string) => Effect<{ status: "success" | "error"; message: string; }, never, never>; tags: (id: number) => Effect<{ status: "success" | "error"; message: string; }, never, never>; ... 4 more ...; user: (userId: string) => Effect<{ status: "success" | "error"; message: string; }, never, never>;}
const diffTracking: { insert: (userId: string, pageId: string, data: { content: { start: string; end: string; }; metaData: { start: Partial<{ readonly description: string; readonly title: string; readonly id: string; readonly package: string; readonly showOnNav: boolean; readonly publishedAt: Date; readonly updatedAt: Date; readonly slug: string; readonly contentLang: string; readonly heroImage?: string | null | undefined; readonly categories: readonly string[]; readonly tags: readonly string[]; readonly authorId: string; readonly contributorIds: readonly string[]; readonly showAuthor: boolean; readonly showContributors: boolean; readonly parentFolder?: string | null | undefined; readonly draft: boolean; readonly augments: readonly string[]; }>; end: Partial<{ ...; }>; }; }, diffLength: number) => Effect<diffReturn, DBCallbackFailure | DatabaseError | ParsersError | DiffError, never>; clear: (input: string) => Effect<DeleteResult[], DBCallbackFailure | DatabaseError, never>; get: { byPageId: { all: (pageId: string) => Effect<diffReturn[], DBCallbackFailure | DatabaseError | ParsersError, never>; latest: (pageId: string, count: number) => Effect<diffReturn[], DBCallbackFailure | DatabaseError | ParsersError, never>; }; byUserId: { all: (userId: string) => Effect<diffReturn[], DBCallbackFailure | DatabaseError | ParsersError, never>; latest: (userId: string, count: number) => Effect<diffReturn[], DBCallbackFailure | DatabaseError | ParsersError, never>; }; single: (diffId: string) => Effect<diffReturn | undefined, DBCallbackFailure | DatabaseError | ParsersError, never>; }; revertToDiff: (id: string, type: "content" | "data" | "both") => Effect<diffReturn, ParseError | DBCallbackFailure | DatabaseError | ParsersError | DiffTrackingError, never>; utils: { getMetaDataDifferences: <T extends Record<string, unknown>>(obj1: T, obj2: T) => Effect<{ label: string; previous: unknown; current: unknown; }[], never, never>; getDiffHTML: (diff: string, options?: Diff2HtmlConfig | undefined) => Effect<string, DiffError, never>; };}
const GET: { permissionsLists: { owners: () => Effect<SingleRank[], UsersError | DBCallbackFailure | DatabaseError, never>; admins: () => Effect<SingleRank[], UsersError | DBCallbackFailure | DatabaseError, never>; editors: () => Effect<SingleRank[], UsersError | DBCallbackFailure | DatabaseError, never>; visitors: () => Effect<SingleRank[], UsersError | DBCallbackFailure | DatabaseError, never>; all: () => Effect<CombinedRank[], DBCallbackFailure | DatabaseError | UsersError, never>; }; ... 12 more ...; tags: { getAll: () => Effect<readonly { readonly id: number; readonly name: string; readonly description: string; readonly slug: string; readonly meta: { readonly [x: string]: unknown; }; }[], DBCallbackFailure | DatabaseError, never>; byId: (tagId: number) => Effect<{ readonly id: number; readonly name: string; readonly description: string; readonly slug: string; readonly meta: { readonly [x: string]: unknown; }; } | undefined, DBCallbackFailure | DatabaseError, never>; bySlug: (slug: string) => Effect<{ readonly id: number; readonly name: string; readonly description: string; readonly slug: string; readonly meta: { readonly [x: string]: unknown; }; } | undefined, DBCallbackFailure | DatabaseError, never>; };}
const INIT: { siteConfig: (data: ConfigFinal<StudioCMSSiteConfig>) => Effect<DynamicConfigEntry<StudioCMSSiteConfig>, DBCallbackFailure | DatabaseError, never>; ghostUser: () => Effect<{ readonly id: string; readonly url?: string | null | undefined; readonly name: string; readonly email?: string | null | undefined; readonly avatar?: string | null | undefined; readonly username: string; readonly password?: string | null | undefined; readonly updatedAt: Date; readonly createdAt: Date; readonly emailVerified: boolean; readonly notifications?: string | null | undefined; }, DBCallbackFailure | DatabaseError, never>;}
const MIDDLEWARES: { verifyCache: () => Effect<void, UnknownException | ParseError | DBCallbackFailure | QueryParseError | QueryError | NotFoundError | FolderTreeError | CollectorError | PaginateError, never>;}
const notificationSettings: { site: { get: () => Effect<DynamicConfigEntry<StudioCMSNotificationSettings>, DBCallbackFailure | DatabaseError, never>; update: (settings: Omit<StudioCMSNotificationSettings, "_config_version">) => Effect<DynamicConfigEntry<StudioCMSNotificationSettings>, DBCallbackFailure | DatabaseError, never>; };}
const PLUGINS: { usePluginData: { <T extends Struct<Struct.Fields> | object, R extends object = T extends Struct<any> ? RecursiveSimplifyMutable<T["Type"]> : T>(pluginId: string, opts?: UsePluginDataOptsBase<T>): { getEntries: (filter?: (data: PluginDataEntry<R>[]) => PluginDataEntry<R>[]) => Effect<PluginDataEntry<R>[], StudioCMSSDKError, never>; getEntry: (id: string) => { generatedId: () => Effect<string, never, never>; select: () => Effect<PluginDataEntry<R> | undefined, StudioCMSSDKError, never>; insert: (data: R) => Effect<PluginDataEntry<R>, StudioCMSSDKError, never>; update: (data: R) => Effect<PluginDataEntry<...>, StudioCMSSDKError, never>; }; }; <T extends Struct<...> | object, R extends object = T extends Struct<...> ? RecursiveSimplifyMutable<...> : T>(pluginId: string, opts?: UsePluginDataOpts<...>): { generatedId: () => Effect<string, never, never>; select: () => Effect<PluginDataEntry<...> | undefined, StudioCMSSDKError, never>; insert: (data: R) => Effect<PluginDataEntry<...>, StudioCMSSDKError, never>; update: (data: R) => Effect<PluginDataEntry<...>, StudioCMSSDKError, never>; }; }; initPluginDataCache: (BATCH_SIZE?: number | undefined) => Effect<void, DBCallbackFailure | DatabaseError, never>; clearPluginDataCache: () => Effect<void, never, never>; InferType: { new <S extends Struct<...>, R = RecursiveSimplifyMutable<...>>(schema: S): { readonly _Schema: S; readonly $UsePluginData: S; readonly $Insert: R; }; };}
const POST: { databaseEntry: { pages: (pageData: OptionalId<string, { readonly id: string; readonly updatedAt: string; readonly description: string; readonly package: string; readonly title: string; readonly showOnNav: boolean; readonly publishedAt: string; readonly slug: string; readonly contentLang: string; readonly heroImage?: string | null | undefined; readonly categories: string; readonly tags: string; readonly authorId: string; readonly contributorIds: string; readonly showAuthor: boolean; readonly showContributors: boolean; readonly parentFolder?: string | null | undefined; readonly draft: boolean; readonly augments: string; }>, pageContent: CombinedInsertContent) => Effect<{ pageData: { readonly id: string; }; pageContent: { readonly id: string; }; }, DBCallbackFailure | DatabaseError, never>; pageContent: (input: { readonly id: string; readonly contentLang: string; readonly contentId: string; readonly content: string; }) => Effect<{ readonly id: string; }, DBCallbackFailure | DatabaseError, never>; tags: (tag: OptionalId<...>) => Effect<{ readonly id: number; }, DBCallbackFailure | DatabaseError | GeneratorError, never>; categories: (category: OptionalId<...>) => Effect<{ readonly id: number; }, DBCallbackFailure | DatabaseError | GeneratorError, never>; permissions: (userId: string, rank: "owner" | "admin" | "editor" | "visitor" | "unknown") => Effect<{ readonly user: string; readonly rank: "owner" | "admin" | "editor" | "visitor" | "unknown"; }, DBCallbackFailure | DatabaseError, never>; diffTracking: (data: OptionalId<...>) => Effect<{ readonly id: string; readonly userId: string; readonly pageId: string; readonly timestamp: Date; readonly pageMetaData: { readonly [x: string]: unknown; }; readonly pageContentStart: string; readonly diff?: string | null | undefined; }, DBCallbackFailure | DatabaseError, never>; folder: (data: OptionalId<...>) => Effect<{ readonly id: string; readonly name: string; readonly parent?: string | null | undefined; }, DBCallbackFailure | DatabaseError, never>; }; databaseEntries: { tags: (tags: OptionalId<...>[]) => Effect<{ readonly id: number; }[], DBCallbackFailure | DatabaseError | GeneratorError, never>; categories: (categories: OptionalId<...>[]) => Effect<{ readonly id: number; }[], DBCallbackFailure | DatabaseError | GeneratorError, never>; permissions: (permissions: { userId: string; rank: "owner" | "admin" | "editor" | "visitor" | "unknown"; }[]) => Effect<{ readonly user: string; readonly rank: "owner" | "admin" | "editor" | "visitor" | "unknown"; }[], DBCallbackFailure | DatabaseError, never>; pages: (pages: MultiPageInsert) => Effect<{ pageData: { readonly id: string; }; pageContent: { readonly id: string; }; }[], DBCallbackFailure | DatabaseError, never>; }; folder: (data: OptionalId<...>) => Effect<{ readonly id: string; readonly name: string; readonly parent?: string | null | undefined; }, DBCallbackFailure | DatabaseError | FolderTreeError, never>; page: (args_0: { pageData: OptionalId<...>; pageContent: CombinedInsertContent; }) => Effect<CombinedPageData | undefined, ParseError | DBCallbackFailure | QueryParseError | QueryError | NotFoundError | FolderTreeError | CollectorError | PaginateError, never>;}
const resetTokenBucket: { new: (userId: string) => Effect<{ readonly id: string; readonly userId: string; readonly token: string; }, DBCallbackFailure | DatabaseError | GeneratorError, never>; delete: (input: string) => Effect<DeleteResult[], DBCallbackFailure | DatabaseError, never>; check: (token: string) => Effect<boolean, DBCallbackFailure | DatabaseError | GeneratorError, never>;}
const REST_API: { tokens: { get: (input: string) => Effect<readonly { readonly id: string; readonly userId: string; readonly key: string; readonly creationDate: Date; readonly description?: string | null | undefined; }[], DBCallbackFailure | DatabaseError, never>; new: (userId: string, description: string) => Effect<{ readonly id: string; readonly userId: string; readonly key: string; readonly creationDate: Date; readonly description?: string | null | undefined; }, DBCallbackFailure | DatabaseError | GeneratorError, never>; delete: (input: { readonly userId: string; readonly tokenId: string; }) => Effect<DeleteResult[], DBCallbackFailure | DatabaseError, never>; verify: (key: string) => Effect<false | { userId: string; key: string; rank: "owner" | "admin" | "editor" | "visitor" | "unknown"; }, DBCallbackFailure | DatabaseError, never>; };}
const UPDATE: { pageContent: (input: { readonly id: string; readonly contentLang: string; readonly contentId: string; readonly content: string; }) => Effect<{ readonly id: string; readonly contentLang: string; readonly contentId: string; readonly content: string; }, DBCallbackFailure | DatabaseError, never>; ... 8 more ...; page: { byId: (pageId: string, data: { pageData: { readonly id: string; readonly updatedAt: string; readonly description: string; readonly package: string; readonly title: string; readonly showOnNav: boolean; readonly publishedAt: string; readonly slug: string; readonly contentLang: string; readonly heroImage?: string | null | undefined; readonly categories: string; readonly tags: string; readonly authorId: string; readonly contributorIds: string; readonly showAuthor: boolean; readonly showContributors: boolean; readonly parentFolder?: string | null | undefined; readonly draft: boolean; readonly augments: string; }; pageContent: { readonly id: string; readonly contentLang: string; readonly contentId: string; readonly content: string; }; }) => Effect<CombinedPageData | undefined, ParseError | DBCallbackFailure | QueryParseError | QueryError | NotFoundError | FolderTreeError | CollectorError | PaginateError, never>; bySlug: (slug: string, data: { pageData: { readonly id: string; readonly updatedAt: string; readonly description: string; readonly package: string; readonly title: string; readonly showOnNav: boolean; readonly publishedAt: string; readonly slug: string; readonly contentLang: string; readonly heroImage?: string | null | undefined; readonly categories: string; readonly tags: string; readonly authorId: string; readonly contributorIds: string; readonly showAuthor: boolean; readonly showContributors: boolean; readonly parentFolder?: string | null | undefined; readonly draft: boolean; readonly augments: string; }; pageContent: { readonly id: string; readonly contentLang: string; readonly contentId: string; readonly content: string; }; }) => Effect<CombinedPageData | undefined, ParseError | DBCallbackFailure | DatabaseError | FolderTreeError | CollectorError | PaginateError, never>; };}
const UTIL: { Collectors: { collectCategories: (input: readonly number[]) => Effect<readonly { readonly id: number; readonly name: string; readonly description: string; readonly parent?: number | null | undefined; readonly slug: string; readonly meta: { readonly [x: string]: unknown; }; }[], DBCallbackFailure | DatabaseError, never>; collectTags: (input: readonly number[]) => Effect<readonly { readonly id: number; readonly name: string; readonly description: string; readonly slug: string; readonly meta: { readonly [x: string]: unknown; }; }[], DBCallbackFailure | DatabaseError, never>; collectPageData: { (page: { readonly description: string; readonly title: string; readonly id: string; readonly package: string; readonly showOnNav: boolean; readonly publishedAt: Date; readonly updatedAt: Date; readonly slug: string; readonly contentLang: string; readonly heroImage?: string | null | undefined; readonly categories: readonly string[]; readonly tags: readonly string[]; readonly authorId: string; ... 5 more ...; readonly augments: readonly string[]; }, tree: FolderNode[]): Effect<CombinedPageData, CollectorError | FolderTreeError | DBCallbackFailure | DatabaseError | ParseError, never>; (page: { ...; }, tree: FolderNode[], metaOnly: boolean): Effect<MetaOnlyPageData, CollectorError | FolderTreeError | DBCallbackFailure | DatabaseError | ParseError, never>; }; collectUserData: (user: { readonly id: string; readonly url?: string | null | undefined; readonly name: string; readonly email?: string | null | undefined; readonly avatar?: string | null | undefined; readonly username: string; readonly password?: string | null | undefined; readonly updatedAt: Date; readonly createdAt: Date; readonly emailVerified: boolean; readonly notifications?: string | null | undefined; }) => Effect<CombinedUserData, DBCallbackFailure | DatabaseError, never>; }; ... 4 more ...; Users: { verifyRank: (users: readonly { readonly id: string; readonly url?: string | null | undefined; readonly name: string; readonly email?: string | null | undefined; readonly avatar?: string | null | undefined; readonly username: string; readonly password?: string | null | undefined; readonly updatedAt: Date; readonly createdAt: Date; readonly emailVerified: boolean; readonly notifications?: string | null | undefined; }[], permissions: readonly { readonly user: string; readonly rank: "owner" | "admin" | "editor" | "visitor" | "unknown"; }[], rank: string) => Effect<SingleRank[], UsersError, never>; combineRanks: (rank: string, users: SingleRank[]) => Effect<CombinedRank[], UsersError, never>; clearUserReferences: (userId: string) => Effect<boolean, DBCallbackFailure | QueryError | NotFoundError, never>; };}
const SDKCoreJs: { AUTH: { verifyEmail: { get: (input: string) => Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; readonly token: string; } | undefined, DBCallbackFailure | DatabaseError, never>; create: (userId: string) => Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; readonly token: string; }, DBCallbackFailure | DatabaseError | GeneratorError, never>; delete: (input: string) => Effect<DeleteResult, DBCallbackFailure | DatabaseError, never>; }; oAuth: { create: (input: { readonly providerUserId: string; readonly provider: string; readonly userId: string; }) => Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; }, DBCallbackFailure | DatabaseError, never>; delete: (input: { readonly userId: string; readonly provider: string; }) => AuthDeletionResponse; searchByProviderId: (input: { readonly providerUserId: string; readonly userId: string; }) => Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; } | undefined, DBCallbackFailure | DatabaseError, never>; searchProvidersForId: (input: { readonly userId: string; readonly providerId: string; }) => Effect<{ readonly providerUserId: string; readonly provider: string; readonly userId: string; } | undefined, DBCallbackFailure | DatabaseError, never>; }; permission: { currentStatus: (input: string) => Effect<{ readonly user: string; readonly rank: "owner" | "admin" | "editor" | "visitor" | "unknown"; } | undefined, DBCallbackFailure | DatabaseError, never>; }; session: { create: (input: { readonly id: string; readonly userId: string; readonly expiresAt: string; }) => Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; }, DBCallbackFailure | DatabaseError, never>; getById: (input: string) => Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; } | undefined, DBCallbackFailure | DatabaseError, never>; sessionWithUser: (sessionId: string) => Effect<{ session: { readonly id: string; readonly userId: string; readonly expiresAt: Date; }; user: { readonly id: string; readonly url?: string | null | undefined; readonly name: string; readonly email?: string | null | undefined; readonly avatar?: string | null | undefined; readonly username: string; readonly password?: string | null | undefined; readonly updatedAt: Date; readonly createdAt: Date; readonly emailVerified: boolean; readonly notifications?: string | null | undefined; }; } | undefined, DBCallbackFailure | DatabaseError, never>; delete: (input: string) => AuthDeletionResponse; update: (input: { readonly id: string; readonly newDate: Date; }) => Effect<{ readonly id: string; readonly userId: string; readonly expiresAt: Date; }, DBCallbackFailure | DatabaseError, never>; }; user: { create: (userData: { readonly id: string; readonly url?: string | null | undefined; readonly name: string; readonly email?: string | null | undefined; readonly avatar?: string | null | undefined; readonly username: string; readonly password?: string | null | undefined; readonly updatedAt: string; readonly createdAt: string | undefined; readonly emailVerified: boolean; readonly notifications?: string | null | undefined; }, rank: "owner" | "admin" | "editor" | "visitor" | "unknown") => Effect<{ readonly id: string; readonly ...
VanillaJS Version of the SDKCore. Most internal functions will still contain Effects, you can use runSDK from the 'studiocms:sdk' to run these as normal async functions
SDKCoreJs;Lectura adicional
Sección titulada «Lectura adicional»El SDK de StudioCMS está impulsado por el paquete @withstudiocms/sdk, que proporciona funcionalidad y utilidades adicionales para trabajar con StudioCMS. Para más información, consulta la documentación de los paquetes Kysely y SDK.