@withstudiocms/sdk 0.1.0-beta.1 → 0.1.0

package/dist/modules/auth/index.js

@@ -1,12 +1,12 @@
 import { Effect, Schema } from "@withstudiocms/effect";
+import { DBClientLive, SDKDefaults } from "../../context.js";
 import {
   StudioCMSEmailVerificationTokens,
   StudioCMSOAuthAccounts,
   StudioCMSPermissions,
   StudioCMSSessionTable,
   StudioCMSUsersTable
-} from "@withstudiocms/kysely";
-import { DBClientLive, SDKDefaults } from "../../context.js";
+} from "../../tables.js";
 import {
   AuthErrorTagsEntries
 } from "../../types.js";
@@ -34,14 +34,22 @@ const SDKAuthModule = Effect.gen(function* () {
     encoder: StudioCMSEmailVerificationTokens.Insert,
     decoder: StudioCMSEmailVerificationTokens.Select,
     callbackFn: (db, data) => db(
-      (client) => client.insertInto("StudioCMSEmailVerificationTokens").values(data).returningAll().executeTakeFirstOrThrow()
+      (client) => client.transaction().execute(async (trx) => {
+        await trx.insertInto("StudioCMSEmailVerificationTokens").values(data).executeTakeFirstOrThrow();
+        return await trx.selectFrom("StudioCMSEmailVerificationTokens").selectAll().where("id", "=", data.id).executeTakeFirstOrThrow();
+      })
     )
   });
   const _createNewOAuthAccount = withCodec({
     encoder: StudioCMSOAuthAccounts.Insert,
     decoder: StudioCMSOAuthAccounts.Select,
     callbackFn: (db, data) => db(
-      (client) => client.insertInto("StudioCMSOAuthAccounts").values(data).returningAll().executeTakeFirstOrThrow()
+      (client) => client.transaction().execute(async (trx) => {
+        await trx.insertInto("StudioCMSOAuthAccounts").values(data).executeTakeFirstOrThrow();
+        return await trx.selectFrom("StudioCMSOAuthAccounts").selectAll().where(
+          (eb) => eb.and([eb("userId", "=", data.userId), eb("provider", "=", data.provider)])
+        ).executeTakeFirstOrThrow();
+      })
     )
   });
   const _deleteOAuthUserAccount = withEncoder({
@@ -86,7 +94,10 @@ const SDKAuthModule = Effect.gen(function* () {
     encoder: StudioCMSSessionTable.Insert,
     decoder: StudioCMSSessionTable.Select,
     callbackFn: (db, data) => db(
-      (client) => client.insertInto("StudioCMSSessionTable").values(data).returningAll().executeTakeFirstOrThrow()
+      (client) => client.transaction().execute(async (trx) => {
+        await trx.insertInto("StudioCMSSessionTable").values(data).executeTakeFirstOrThrow();
+        return await trx.selectFrom("StudioCMSSessionTable").selectAll().where("id", "=", data.id).executeTakeFirstOrThrow();
+      })
     )
   });
   const _getUserById = withCodec({
@@ -116,21 +127,30 @@ const SDKAuthModule = Effect.gen(function* () {
     }),
     decoder: StudioCMSSessionTable.Select,
     callbackFn: (db, { id, newDate }) => db(
-      (client) => client.updateTable("StudioCMSSessionTable").set({ expiresAt: newDate }).where("id", "=", id).returningAll().executeTakeFirstOrThrow()
+      (client) => client.transaction().execute(async (trx) => {
+        await trx.updateTable("StudioCMSSessionTable").set({ expiresAt: newDate }).where("id", "=", id).executeTakeFirstOrThrow();
+        return await trx.selectFrom("StudioCMSSessionTable").selectAll().where("id", "=", id).executeTakeFirstOrThrow();
+      })
     )
   });
   const _createNewUser = withCodec({
     encoder: StudioCMSUsersTable.Insert,
     decoder: StudioCMSUsersTable.Select,
     callbackFn: (db, data) => db(
-      (client) => client.insertInto("StudioCMSUsersTable").values(data).returningAll().executeTakeFirstOrThrow()
+      (client) => client.transaction().execute(async (trx) => {
+        await trx.insertInto("StudioCMSUsersTable").values(data).executeTakeFirstOrThrow();
+        return await trx.selectFrom("StudioCMSUsersTable").selectAll().where("id", "=", data.id).executeTakeFirstOrThrow();
+      })
     )
   });
   const _createUserPermission = withCodec({
     encoder: StudioCMSPermissions.Insert,
     decoder: StudioCMSPermissions.Select,
     callbackFn: (db, data) => db(
-      (client) => client.insertInto("StudioCMSPermissions").values(data).returningAll().executeTakeFirstOrThrow()
+      (client) => client.transaction().execute(async (trx) => {
+        await trx.insertInto("StudioCMSPermissions").values(data).executeTakeFirstOrThrow();
+        return await trx.selectFrom("StudioCMSPermissions").selectAll().where("user", "=", data.user).executeTakeFirstOrThrow();
+      })
     )
   });
   const _updateUserData = withCodec({
@@ -140,7 +160,10 @@ const SDKAuthModule = Effect.gen(function* () {
     }),
     decoder: StudioCMSUsersTable.Select,
     callbackFn: (db, { userId, userData }) => db(
-      (client) => client.updateTable("StudioCMSUsersTable").set(userData).where("id", "=", userId).returningAll().executeTakeFirstOrThrow()
+      (client) => client.transaction().execute(async (trx) => {
+        await trx.updateTable("StudioCMSUsersTable").set(userData).where("id", "=", userId).executeTakeFirstOrThrow();
+        return await trx.selectFrom("StudioCMSUsersTable").selectAll().where("id", "=", userId).executeTakeFirstOrThrow();
+      })
     )
   });
   const _searchForUsername = withCodec({
@@ -213,6 +236,7 @@ const SDKAuthModule = Effect.gen(function* () {
         (user2) => user2 ? Effect.succeed(user2) : _createNewUser({
           ...GhostUserDefaults,
           updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+          createdAt: (/* @__PURE__ */ new Date()).toISOString(),
           emailVerified: false
         })
       )

package/dist/modules/config/index.d.ts

@@ -1,8 +1,8 @@
 import { Deepmerge, Effect } from '@withstudiocms/effect';
-import type { DBCallbackFailure } from '@withstudiocms/kysely';
+import type { DBCallbackFailure } from '@withstudiocms/kysely/client';
 import type { DatabaseError } from '@withstudiocms/kysely/core/errors';
 import { CacheService } from '../../cache.js';
-import { DBClientLive } from '../../context.js';
+import { DBClientLive, StorageManagerResolver } from '../../context.js';
 import type { ConfigFinal, DynamicConfigEntry, StudioCMSMailerConfig, StudioCMSNotificationSettings, StudioCMSSiteConfig, StudioCMSTemplateConfig } from '../../types.js';
 /**
  * StudioCMS Configuration Modules
@@ -14,7 +14,7 @@ export declare const SDKConfigModule: Effect.Effect<{
          *
          * @returns An effect that yields the site configuration entry or undefined if not found, or a database error.
          */
-        get: () => Effect.Effect<DynamicConfigEntry<StudioCMSSiteConfig> | undefined, DBCallbackFailure | DatabaseError, never>;
+        get: <T extends StudioCMSSiteConfig>() => Effect.Effect<DynamicConfigEntry<T> | undefined, import("effect/Cause").UnknownException | DBCallbackFailure | DatabaseError, never>;
         /**
          * Updates the site configuration.
          *
@@ -87,7 +87,7 @@ export declare const SDKConfigModule: Effect.Effect<{
          * @param data - The new template configuration data to merge and store.
          * @returns An effect that yields the updated template configuration entry or a database error.
          */
-        update: (data: ConfigFinal<StudioCMSTemplateConfig>) => Effect.Effect<DynamicConfigEntry<StudioCMSTemplateConfig>, Error, never>;
+        update: (data: ConfigFinal<StudioCMSTemplateConfig>) => Effect.Effect<DynamicConfigEntry<StudioCMSTemplateConfig>, DBCallbackFailure | DatabaseError | import("@withstudiocms/effect").DeepmergeError, never>;
         /**
          * Initializes the template configuration.
          *
@@ -96,5 +96,5 @@ export declare const SDKConfigModule: Effect.Effect<{
          */
         init: (data: ConfigFinal<StudioCMSTemplateConfig>) => Effect.Effect<DynamicConfigEntry<StudioCMSTemplateConfig>, DBCallbackFailure | DatabaseError, never>;
     };
-}, never, DBClientLive | CacheService | Deepmerge>;
+}, never, DBClientLive | StorageManagerResolver | CacheService | Deepmerge>;
 export default SDKConfigModule;

package/dist/modules/config/index.js

@@ -1,8 +1,9 @@
 import { Deepmerge, Effect, Schema } from "@withstudiocms/effect";
-import { StudioCMSDynamicConfigSettings } from "@withstudiocms/kysely/tables";
 import { CacheMissError, CacheService } from "../../cache.js";
 import { cacheKeyGetters, cacheTags } from "../../consts.js";
-import { DBClientLive } from "../../context.js";
+import { DBClientLive, StorageManagerResolver } from "../../context.js";
+import { resolveStorageManagerUrls } from "../../lib/storage-manager.js";
+import { StudioCMSDynamicConfigSettings } from "../../tables.js";
 import {
   MailerConfigId,
   MailerConfigVersion,
@@ -18,16 +19,27 @@ import { castData } from "./type-utils.js";
 const cacheKey = cacheKeyGetters.dynamicConfig;
 const cacheOpts = { tags: cacheTags.dynamicConfig };
 const SDKConfigModule = Effect.gen(function* () {
-  const [{ withCodec }, { merge }, cache] = yield* Effect.all([
+  const [{ withCodec }, { merge }, cache, smResolver] = yield* Effect.all([
     DBClientLive,
     Deepmerge,
-    CacheService
+    CacheService,
+    StorageManagerResolver
   ]);
+  const resolveUrls = resolveStorageManagerUrls(smResolver);
+  const resolveStorageManagerUrl = (attributes) => (obj) => resolveUrls(obj?.data, attributes).pipe(
+    Effect.map((data) => {
+      if (!data) return obj;
+      return { ...obj, data };
+    })
+  );
   const _insert = withCodec({
     decoder: StudioCMSDynamicConfigSettings.Select,
     encoder: StudioCMSDynamicConfigSettings.Insert,
     callbackFn: (db, data) => db(
-      (client) => client.insertInto("StudioCMSDynamicConfigSettings").values(data).returning(["id", "data"]).executeTakeFirstOrThrow()
+      (client) => client.transaction().execute(async (trx) => {
+        await trx.insertInto("StudioCMSDynamicConfigSettings").values(data).executeTakeFirstOrThrow();
+        return await trx.selectFrom("StudioCMSDynamicConfigSettings").selectAll().where("id", "=", data.id).executeTakeFirstOrThrow();
+      })
     )
   });
   const _select = withCodec({
@@ -41,7 +53,10 @@ const SDKConfigModule = Effect.gen(function* () {
     decoder: StudioCMSDynamicConfigSettings.Select,
     encoder: StudioCMSDynamicConfigSettings.Update,
     callbackFn: (db, { id, data }) => db(
-      (client) => client.updateTable("StudioCMSDynamicConfigSettings").set({ data }).where("id", "=", id).returning(["id", "data"]).executeTakeFirstOrThrow()
+      (client) => client.transaction().execute(async (trx) => {
+        await trx.updateTable("StudioCMSDynamicConfigSettings").set({ data }).where("id", "=", id).executeTakeFirstOrThrow();
+        return await trx.selectFrom("StudioCMSDynamicConfigSettings").selectAll().where("id", "=", id).executeTakeFirstOrThrow();
+      })
     )
   });
   const _tappedCacheUpdate = (fn) => Effect.fn(
@@ -74,7 +89,11 @@ const SDKConfigModule = Effect.gen(function* () {
      *
      * @returns An effect that yields the site configuration entry or undefined if not found, or a database error.
      */
-    get: () => get(SiteConfigId),
+    get: () => get(SiteConfigId).pipe(
+      Effect.flatMap(
+        resolveStorageManagerUrl(["siteIcon", "defaultOgImage", "loginPageCustomImage"])
+      )
+    ),
     /**
      * Updates the site configuration.
      *

package/dist/modules/delete/index.d.ts

@@ -1,4 +1,5 @@
 import { Effect } from '@withstudiocms/effect';
+import CacheService from '../../cache.js';
 import { DBClientLive, SDKDefaults } from '../../context.js';
 /**
  * SDKDeleteModule
@@ -136,5 +137,5 @@ export declare const SDKDeleteModule: Effect.Effect<{
         status: "success" | "error";
         message: string;
     }, never, never>;
-}, never, DBClientLive | SDKDefaults | import("../../cache.js").CacheService | import("@withstudiocms/effect").Deepmerge>;
+}, never, DBClientLive | SDKDefaults | import("../../context.js").StorageManagerResolver | CacheService | import("@withstudiocms/effect").Deepmerge>;
 export default SDKDeleteModule;

package/dist/modules/delete/index.js

@@ -1,4 +1,6 @@
 import { Effect, Schema } from "@withstudiocms/effect";
+import CacheService from "../../cache.js";
+import { cacheTags } from "../../consts.js";
 import { DBClientLive, SDKDefaults } from "../../context.js";
 import SDKClearModule from "../clear/index.js";
 import SDKUpdateModule from "../update/index.js";
@@ -25,12 +27,13 @@ const _handleErrors = Effect.catchTags({
   })
 });
 const SDKDeleteModule = Effect.gen(function* () {
-  const [{ withEncoder }, clear, users, update, { GhostUserDefaults }] = yield* Effect.all([
+  const [{ withEncoder }, clear, users, update, { GhostUserDefaults }, { invalidateTags }] = yield* Effect.all([
     DBClientLive,
     SDKClearModule,
     SDKUsers,
     SDKUpdateModule,
-    SDKDefaults
+    SDKDefaults,
+    CacheService
   ]);
   const _deleteDiffTrackingByPageId = withEncoder({
     encoder: Schema.String,
@@ -129,6 +132,7 @@ const SDKDeleteModule = Effect.gen(function* () {
   );
   const _deletePageTag = Effect.fn(
     (id) => _deleteTagsById(id).pipe(
+      Effect.tap(() => invalidateTags(cacheTags.tags)),
       Effect.map(() => ({
         status: "success",
         message: `Tag with ID ${id} has been deleted successfully`
@@ -138,6 +142,7 @@ const SDKDeleteModule = Effect.gen(function* () {
   );
   const _deletePageCategory = Effect.fn(
     (id) => _deleteCategoriesById(id).pipe(
+      Effect.tap(() => invalidateTags(cacheTags.categories)),
       Effect.map(() => ({
         status: "success",
         message: `Category with ID ${id} has been deleted successfully`

package/dist/modules/diffTracking/index.d.ts

@@ -109,14 +109,14 @@ export declare const SDKDiffTrackingModule: Effect.Effect<{
             start: Partial<tsPageDataSelect>;
             end: Partial<tsPageDataSelect>;
         };
-    }, diffLength: number) => Effect.Effect<diffReturn, import("@withstudiocms/kysely").DBCallbackFailure | import("@withstudiocms/kysely/core/errors").DatabaseError | import("../util/parsers.js").ParsersError | import("../../lib/diff.js").DiffError, never>;
+    }, diffLength: number) => Effect.Effect<diffReturn, import("@withstudiocms/kysely/client").DBCallbackFailure | import("@withstudiocms/kysely/core/errors").DatabaseError | import("../util/parsers.js").ParsersError | import("../../lib/diff.js").DiffError, never>;
     /**
      * Clears all diff tracking records for a given page ID.
      *
      * @param pageId - The ID of the page to clear diff tracking records for.
      * @returns The number of rows affected by the delete operation.
      */
-    clear: (input: string) => Effect.Effect<import("kysely").DeleteResult[], import("@withstudiocms/kysely").DBCallbackFailure | import("@withstudiocms/kysely/core/errors").DatabaseError, never>;
+    clear: (input: string) => Effect.Effect<import("kysely").DeleteResult[], import("@withstudiocms/kysely/client").DBCallbackFailure | import("@withstudiocms/kysely/core/errors").DatabaseError, never>;
     /**
      * Utility functions for retrieving diff tracking records.
      */
@@ -128,11 +128,11 @@ export declare const SDKDiffTrackingModule: Effect.Effect<{
             /**
              * Retrieves all diff tracking records for a given page ID.
              */
-            all: (pageId: string) => Effect.Effect<diffReturn[], import("@withstudiocms/kysely").DBCallbackFailure | import("@withstudiocms/kysely/core/errors").DatabaseError | import("../util/parsers.js").ParsersError, never>;
+            all: (pageId: string) => Effect.Effect<diffReturn[], import("@withstudiocms/kysely/client").DBCallbackFailure | import("@withstudiocms/kysely/core/errors").DatabaseError | import("../util/parsers.js").ParsersError, never>;
             /**
              * Retrieves the latest `count` diff tracking records for a given page ID.
              */
-            latest: (pageId: string, count: number) => Effect.Effect<diffReturn[], import("@withstudiocms/kysely").DBCallbackFailure | import("@withstudiocms/kysely/core/errors").DatabaseError | import("../util/parsers.js").ParsersError, never>;
+            latest: (pageId: string, count: number) => Effect.Effect<diffReturn[], import("@withstudiocms/kysely/client").DBCallbackFailure | import("@withstudiocms/kysely/core/errors").DatabaseError | import("../util/parsers.js").ParsersError, never>;
         };
         /**
          * Retrieves all diff tracking records for a given user ID.
@@ -141,16 +141,16 @@ export declare const SDKDiffTrackingModule: Effect.Effect<{
             /**
              * Retrieves all diff tracking records for a given user ID.
              */
-            all: (userId: string) => Effect.Effect<diffReturn[], import("@withstudiocms/kysely").DBCallbackFailure | import("@withstudiocms/kysely/core/errors").DatabaseError | import("../util/parsers.js").ParsersError, never>;
+            all: (userId: string) => Effect.Effect<diffReturn[], import("@withstudiocms/kysely/client").DBCallbackFailure | import("@withstudiocms/kysely/core/errors").DatabaseError | import("../util/parsers.js").ParsersError, never>;
             /**
              * Retrieves the latest `count` diff tracking records for a given user ID.
              */
-            latest: (userId: string, count: number) => Effect.Effect<diffReturn[], import("@withstudiocms/kysely").DBCallbackFailure | import("@withstudiocms/kysely/core/errors").DatabaseError | import("../util/parsers.js").ParsersError, never>;
+            latest: (userId: string, count: number) => Effect.Effect<diffReturn[], import("@withstudiocms/kysely/client").DBCallbackFailure | import("@withstudiocms/kysely/core/errors").DatabaseError | import("../util/parsers.js").ParsersError, never>;
         };
         /**
          * Retrieves a single diff tracking record by its ID.
          */
-        single: (diffId: string) => Effect.Effect<diffReturn | undefined, import("@withstudiocms/kysely").DBCallbackFailure | import("@withstudiocms/kysely/core/errors").DatabaseError | import("../util/parsers.js").ParsersError, never>;
+        single: (diffId: string) => Effect.Effect<diffReturn | undefined, import("@withstudiocms/kysely/client").DBCallbackFailure | import("@withstudiocms/kysely/core/errors").DatabaseError | import("../util/parsers.js").ParsersError, never>;
     };
     /**
      * Reverts the page data and/or content to the state represented by the specified diff ID.
@@ -159,7 +159,7 @@ export declare const SDKDiffTrackingModule: Effect.Effect<{
      * @param type - The type of revert operation: 'content', 'data', or 'both'.
      * @returns The reverted diff tracking record with parsed metadata.
      */
-    revertToDiff: (id: string, type: "data" | "content" | "both") => Effect.Effect<diffReturn, import("effect/ParseResult").ParseError | import("@withstudiocms/kysely").DBCallbackFailure | import("@withstudiocms/kysely/core/errors").DatabaseError | import("../util/parsers.js").ParsersError | DiffTrackingError, never>;
+    revertToDiff: (id: string, type: "content" | "data" | "both") => Effect.Effect<diffReturn, import("effect/ParseResult").ParseError | import("@withstudiocms/kysely/client").DBCallbackFailure | import("@withstudiocms/kysely/core/errors").DatabaseError | import("../util/parsers.js").ParsersError | DiffTrackingError, never>;
     /**
      * Utility functions for diff tracking.
      */

package/dist/modules/diffTracking/index.js

@@ -1,7 +1,7 @@
 import { Data, Effect, Schema } from "@withstudiocms/effect";
-import { StudioCMSDiffTracking, StudioCMSPageData } from "@withstudiocms/kysely";
 import { DBClientLive } from "../../context.js";
 import { createTwoFilesPatch, diffHTML } from "../../lib/diff.js";
+import { StudioCMSDiffTracking, StudioCMSPageData } from "../../tables.js";
 import { SDKParsers } from "../util/parsers.js";
 class DiffTrackingError extends Data.TaggedError("DiffTrackingError") {
 }
@@ -36,7 +36,10 @@ const SDKDiffTrackingModule = Effect.gen(function* () {
     encoder: StudioCMSDiffTracking.Insert,
     decoder: StudioCMSDiffTracking.Select,
     callbackFn: (db, diff) => db(
-      (client) => client.insertInto("StudioCMSDiffTracking").values(diff).returningAll().executeTakeFirstOrThrow()
+      (client) => client.transaction().execute(async (trx) => {
+        await trx.insertInto("StudioCMSDiffTracking").values(diff).executeTakeFirstOrThrow();
+        return await trx.selectFrom("StudioCMSDiffTracking").selectAll().where("id", "=", diff.id).executeTakeFirstOrThrow();
+      })
     )
   });
   const clearPageDiffs = withEncoder({
@@ -111,16 +114,14 @@ const SDKDiffTrackingModule = Effect.gen(function* () {
   const _revertToDiff = Effect.fn(function* (id, type) {
     const diffEntry = yield* _selectDiffById(id);
     if (!diffEntry) {
-      return yield* Effect.fail(new DiffTrackingError({ message: "Diff entry not found" }));
+      return yield* new DiffTrackingError({ message: "Diff entry not found" });
     }
     const shouldRevertData = type === "data" || type === "both";
     const shouldRevertContent = type === "content" || type === "both";
     if (shouldRevertData) {
       const pageData = diffEntry.pageMetaData;
       if (!pageData.end.id || !pageData.start.id) {
-        return yield* Effect.fail(
-          new DiffTrackingError({ message: "Invalid page metadata for revert" })
-        );
+        return yield* new DiffTrackingError({ message: "Invalid page metadata for revert" });
       }
       yield* Schema.encode(StudioCMSPageData.Select)(pageData.start).pipe(
         Effect.flatMap(Schema.decode(StudioCMSPageData.Update)),

package/dist/modules/get/index.d.ts

@@ -1,5 +1,5 @@
 import { Effect, type ParseResult } from '@withstudiocms/effect';
-import { type DBCallbackFailure } from '@withstudiocms/kysely';
+import type { DBCallbackFailure } from '@withstudiocms/kysely/client';
 import type { DatabaseError } from '@withstudiocms/kysely/core/errors';
 import CacheService from '../../cache.js';
 import { DBClientLive, SDKDefaults } from '../../context.js';
@@ -70,10 +70,9 @@ export declare class KillSwitch {
  * - GET.latestVersion()
  *   - Fetches the latest published version of StudioCMS from NPM.
  *
- * - GET.pages(includeDrafts?, hideDefaultIndex?, metaOnly?, paginate?)
+ * - GET.pages(includeDrafts?, metaOnly?, paginate?)
  *   - Returns all pages (optionally paginated) and supports:
  *     - includeDrafts: include drafts when true.
- *     - hideDefaultIndex: exclude pages with slug "index" when true.
  *     - metaOnly: when true returns meta-only representations (no defaultContent / multiLangContent).
  *   - Validates pagination inputs (non-negative; default limit fallback).
  *   - Uses memoized per-page collectors and returns either CombinedPageData[] or MetaOnlyPageData[].
@@ -91,13 +90,14 @@ export declare class KillSwitch {
  * - GET.packagePages(packageName, metaOnly?)
  *   - Returns pages associated with a package. If none found, returns an empty array.
  *
- * - GET.folderPages(idOrName, includeDrafts?, hideDefaultIndex?, metaOnly?, paginate?)
+ * - GET.folderPages(idOrName, includeDrafts?, metaOnly?, paginate?)
  *   - Returns pages that belong to the given folder (identified by id or name).
  *   - Supports same filtering, metaOnly and pagination semantics as GET.pages.
  *
- * - GET.pageFolderTree(hideDefaultIndex?)
+ * - GET.pageFolderTree(excludeDrafts?)
  *   - Returns a full folder tree structure enriched with pages placed into their folders.
  *   - Built by merging folder definitions and page data, memoized for efficiency.
+ *   - Supports excluding draft pages when `excludeDrafts` is true.
  *
  * Implementation notes
  * - Internal helpers:
@@ -117,7 +117,6 @@ export declare class KillSwitch {
  * Example usage (conceptual)
  * - GET.users.all()            -> Effect yielding collected user list
  * - GET.page.byId("abc")       -> Effect yielding CombinedPageData | undefined
- * - GET.pages(undefined, true) -> Effect yielding page list with default-index hidden
  *
  * Returns
  * - An object (`GET`) with the described grouped read-only operations; each operation is an Effect-producing function.
@@ -177,9 +176,9 @@ export declare const SDKGetModule: Effect.Effect<{
      * @returns The folder record if found, otherwise undefined.
      */
     folder: (folderId: string) => Effect.Effect<{
-        readonly name: string;
         readonly id: string;
-        readonly parent: string | null | undefined;
+        readonly name: string;
+        readonly parent?: string | null | undefined;
     } | undefined, DBCallbackFailure | DatabaseError, never>;
     /**
      * Retrieves the folder tree structure.
@@ -198,7 +197,7 @@ export declare const SDKGetModule: Effect.Effect<{
      *
      * @returns The site configuration object.
      */
-    siteConfig: () => Effect.Effect<import("../../types.js").DynamicConfigEntry<import("../../types.js").StudioCMSSiteConfig> | undefined, DBCallbackFailure | DatabaseError, never>;
+    siteConfig: <T extends import("../../types.js").StudioCMSSiteConfig>() => Effect.Effect<import("../../types.js").DynamicConfigEntry<T> | undefined, import("effect/Cause").UnknownException | DBCallbackFailure | DatabaseError, never>;
     /**
      * Retrieves the latest version of StudioCMS from NPM.
      *
@@ -207,15 +206,15 @@ export declare const SDKGetModule: Effect.Effect<{
     latestVersion: () => Effect.Effect<{
         version: string;
         lastCacheUpdate: Date;
-    }, import("effect/Cause").UnknownException | Error | ParseResult.ParseError, never>;
+    }, import("effect/Cause").UnknownException | ParseResult.ParseError | import("../util/getFromNPM.js").GetFromNPMError, never>;
     /**
      * Retrieves all pages.
      *
      * @returns An array of page data records.
      */
     pages: {
-        (includeDrafts?: boolean, hideDefaultIndex?: boolean, metaOnly?: false, paginate?: PaginateInput): Effect.Effect<CombinedPageData[], ParseResult.ParseError | DBCallbackFailure | DatabaseError | FolderTreeError | CollectorError | PaginateError, never>;
-        (includeDrafts?: boolean, hideDefaultIndex?: boolean, metaOnly?: true, paginate?: PaginateInput): Effect.Effect<MetaOnlyPageData[], ParseResult.ParseError | DBCallbackFailure | DatabaseError | FolderTreeError | CollectorError | PaginateError, never>;
+        (includeDrafts?: boolean, metaOnly?: false, paginate?: PaginateInput): Effect.Effect<CombinedPageData[], ParseResult.ParseError | DBCallbackFailure | DatabaseError | FolderTreeError | CollectorError | PaginateError, never>;
+        (includeDrafts?: boolean, metaOnly?: true, paginate?: PaginateInput): Effect.Effect<MetaOnlyPageData[], ParseResult.ParseError | DBCallbackFailure | DatabaseError | FolderTreeError | CollectorError | PaginateError, never>;
     };
     /**
      * Utilities to get pages by specific criteria.
@@ -259,14 +258,115 @@ export declare const SDKGetModule: Effect.Effect<{
      * @returns An array of page data records within the specified folder.
      */
     folderPages: {
-        (idOrName: string, includeDrafts?: boolean, hideDefaultIndex?: boolean, metaOnly?: false, paginate?: PaginateInput): Effect.Effect<CombinedPageData[], ParseResult.ParseError | DBCallbackFailure | DatabaseError | FolderTreeError | CollectorError | PaginateError, never>;
-        (idOrName: string, includeDrafts?: boolean, hideDefaultIndex?: boolean, metaOnly?: true, paginate?: PaginateInput): Effect.Effect<MetaOnlyPageData[], ParseResult.ParseError | DBCallbackFailure | DatabaseError | FolderTreeError | CollectorError | PaginateError, never>;
+        (idOrName: string, includeDrafts?: boolean, metaOnly?: false, paginate?: PaginateInput): Effect.Effect<CombinedPageData[], ParseResult.ParseError | DBCallbackFailure | DatabaseError | FolderTreeError | CollectorError | PaginateError, never>;
+        (idOrName: string, includeDrafts?: boolean, metaOnly?: true, paginate?: PaginateInput): Effect.Effect<MetaOnlyPageData[], ParseResult.ParseError | DBCallbackFailure | DatabaseError | FolderTreeError | CollectorError | PaginateError, never>;
     };
     /**
      * Retrieves the page folder tree structure.
      *
      * @returns The page folder tree structure.
      */
-    pageFolderTree: (hideDefaultIndex?: boolean) => Effect.Effect<import("../../types.js").FolderNode[], ParseResult.ParseError | DBCallbackFailure | import("@withstudiocms/kysely/core/errors").QueryParseError | import("@withstudiocms/kysely/core/errors").QueryError | import("@withstudiocms/kysely/core/errors").NotFoundError | FolderTreeError | CollectorError | PaginateError, never>;
-}, never, DBClientLive | SDKDefaults | CacheService | import("@withstudiocms/effect").Deepmerge>;
+    pageFolderTree: (excludeDrafts?: boolean) => Effect.Effect<import("../../types.js").FolderNode[], ParseResult.ParseError | DBCallbackFailure | import("@withstudiocms/kysely/core/errors").QueryParseError | import("@withstudiocms/kysely/core/errors").QueryError | import("@withstudiocms/kysely/core/errors").NotFoundError | FolderTreeError | CollectorError | PaginateError, never>;
+    /**
+     * Category-related GET operations.
+     */
+    categories: {
+        /**
+         * Retrieves all categories.
+         *
+         * @returns An array of category records.
+         */
+        getAll: () => Effect.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>;
+        /**
+         * Retrieves a category by its ID.
+         *
+         * @param categoryId - The ID of the category to fetch.
+         * @returns The category record if found, otherwise undefined.
+         */
+        byId: (categoryId: number) => Effect.Effect<{
+            readonly id: number;
+            readonly name: string;
+            readonly description: string;
+            readonly parent?: number | null | undefined;
+            readonly slug: string;
+            readonly meta: {
+                readonly [x: string]: unknown;
+            };
+        } | undefined, DBCallbackFailure | DatabaseError, never>;
+        /**
+         * Retrieves a category by its slug.
+         *
+         * @param slug - The slug of the category to fetch.
+         * @returns The category record if found, otherwise undefined.
+         */
+        bySlug: (slug: string) => Effect.Effect<{
+            readonly id: number;
+            readonly name: string;
+            readonly description: string;
+            readonly parent?: number | null | undefined;
+            readonly slug: string;
+            readonly meta: {
+                readonly [x: string]: unknown;
+            };
+        } | undefined, DBCallbackFailure | DatabaseError, never>;
+    };
+    /**
+     * Tag-related GET operations.
+     */
+    tags: {
+        /**
+         * Retrieves all tags.
+         *
+         * @returns An array of tag records.
+         */
+        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>;
+        /**
+         * Retrieves a tag by its ID.
+         *
+         * @param tagId - The ID of the tag to fetch.
+         * @returns The tag record if found, otherwise undefined.
+         */
+        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>;
+        /**
+         * Retrieves a tag by its slug.
+         *
+         * @param slug - The slug of the tag to fetch.
+         * @returns The tag record if found, otherwise undefined.
+         */
+        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>;
+    };
+}, never, DBClientLive | SDKDefaults | import("../../context.js").StorageManagerResolver | CacheService | import("@withstudiocms/effect").Deepmerge>;
 export default SDKGetModule;