@btst/stack 3.0.0-rc.1 → 3.0.0-rc.3

package/dist/plugins/ai-chat/query-keys.mjs

@@ -1,19 +1,125 @@
 import { createResourceQueryKeys } from '@btst/stack/plugins/client';
 
+const referenceObjectTokens = /* @__PURE__ */ new WeakMap();
+const referenceSymbolTokens = /* @__PURE__ */ new WeakMap();
+let nextIdentityReferenceToken = 0;
+function referenceObjectToken(value) {
+  let token = referenceObjectTokens.get(value);
+  if (token === void 0) {
+    token = ++nextIdentityReferenceToken;
+    referenceObjectTokens.set(value, token);
+  }
+  return token;
+}
+function referenceSymbolToken(value) {
+  const registeredKey = Symbol.keyFor(value);
+  if (registeredKey !== void 0) {
+    return `registered:${JSON.stringify(registeredKey)}`;
+  }
+  let token = referenceSymbolTokens.get(value);
+  if (token === void 0) {
+    token = ++nextIdentityReferenceToken;
+    referenceSymbolTokens.set(value, token);
+  }
+  return `local:${token}`;
+}
+function stableIdentityValue(value, seen) {
+  if (value === null) return "null";
+  switch (typeof value) {
+    case "string":
+      return `string:${JSON.stringify(value)}`;
+    case "number":
+      return `number:${Object.is(value, -0) ? "-0" : String(value)}`;
+    case "boolean":
+      return `boolean:${value}`;
+    case "bigint":
+      return `bigint:${value}`;
+    case "undefined":
+      return "undefined";
+    case "symbol":
+      return `symbol:${referenceSymbolToken(value)}`;
+    case "function":
+      return `function:${referenceObjectToken(value)}`;
+  }
+  const object = value;
+  const reference = seen.get(object);
+  if (reference !== void 0) return `reference:${reference}`;
+  seen.set(object, seen.size);
+  if (value instanceof Date) {
+    const timestamp = value.getTime();
+    return `date:${Number.isNaN(timestamp) ? "invalid" : value.toISOString()}`;
+  }
+  if (value instanceof RegExp) {
+    return `regexp:${JSON.stringify(value.source)}:${value.flags}`;
+  }
+  if (value instanceof Set) {
+    return `set:{${[...value].map((item) => stableIdentityValue(item, seen)).sort().join(",")}}`;
+  }
+  if (value instanceof Map) {
+    return `map:{${[...value].map(
+      ([key, item]) => `${stableIdentityValue(key, seen)}=>${stableIdentityValue(item, seen)}`
+    ).sort().join(",")}}`;
+  }
+  if (value instanceof ArrayBuffer || ArrayBuffer.isView(value)) {
+    const bytes = value instanceof ArrayBuffer ? new Uint8Array(value) : new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
+    return `bytes:${value.constructor.name}:${referenceObjectToken(value)}:${[
+      ...bytes
+    ].map((byte) => byte.toString(16).padStart(2, "0")).join("")}`;
+  }
+  if (Array.isArray(value)) {
+    return `array:${value.length}:[${Array.from(
+      { length: value.length },
+      (_, index) => index in value ? stableIdentityValue(value[index], seen) : "array-hole"
+    ).join(",")}]`;
+  }
+  const prototype = Object.getPrototypeOf(value);
+  const kind = prototype === Object.prototype || prototype === null ? "object" : `object:${value.constructor?.name ?? "unknown"}:${referenceObjectToken(value)}`;
+  return `${kind}:{${Object.keys(value).sort().map(
+    (key) => `${JSON.stringify(key)}:${stableIdentityValue(
+      value[key],
+      seen
+    )}`
+  ).join(",")}}`;
+}
+function identityFingerprint(identity) {
+  let input;
+  try {
+    input = stableIdentityValue(identity, /* @__PURE__ */ new Map());
+  } catch {
+    input = `uninspectable-identity:${referenceObjectToken(identity)}`;
+  }
+  let left = 2166136261;
+  let right = 2654435769;
+  for (let index = 0; index < input.length; index++) {
+    const code = input.charCodeAt(index);
+    left = Math.imul(left ^ code, 16777619);
+    right = Math.imul(right ^ code, 2246822507);
+  }
+  return `${(left >>> 0).toString(16).padStart(8, "0")}${(right >>> 0).toString(16).padStart(8, "0")}`;
+}
+function aiChatIdentityKey(identityPartition) {
+  return typeof identityPartition === "string" ? identityPartition : {
+    id: identityPartition.id,
+    fingerprint: identityFingerprint(identityPartition)
+  };
+}
 const aiChatResources = {
   conversations: {
     queries: {
       list: {
         path: "/chat/conversations",
-        key: () => ["all"],
-        select: (data) => data ?? []
+        key: (identityPartition) => identityPartition === void 0 ? ["all"] : ["all", { identity: aiChatIdentityKey(identityPartition) }],
+        select: (data, _identityPartition) => data ?? [],
+        skip: (identityPartition) => identityPartition !== void 0 && typeof identityPartition === "string" && (identityPartition.startsWith("pending:") || identityPartition.startsWith("error:"))
       },
       detail: {
         path: "/chat/conversations/:id",
-        params: (id) => ({ id }),
-        key: (id) => [id],
-        select: (data) => data,
-        skip: (id) => !id
+        params: (id, _identityPartition) => ({
+          id
+        }),
+        key: (id, identityPartition) => identityPartition === void 0 ? [id] : [id, { identity: aiChatIdentityKey(identityPartition) }],
+        select: (data, _id, _identityPartition) => data,
+        skip: (id, identityPartition) => !id || identityPartition !== void 0 && typeof identityPartition === "string" && (identityPartition.startsWith("pending:") || identityPartition.startsWith("error:"))
       }
     },
     mutations: {
@@ -22,7 +128,7 @@ const aiChatResources = {
         method: "POST",
         input: (input) => ({ body: input }),
         select: (data) => data,
-        invalidates: ["conversations.list"]
+        refresh: false
       },
       rename: {
         path: "@put/chat/conversations/:id",
@@ -32,23 +138,14 @@ const aiChatResources = {
           body: { title: input.title }
         }),
         select: (data) => data,
-        invalidates: ["conversations.list"],
-        setData: {
-          args: (result) => result?.id ? [result.id] : null,
-          updater: (previous, result) => previous && result ? { ...previous, ...result } : previous
-        }
+        refresh: false
       },
       delete: {
         path: "@delete/chat/conversations/:id",
         method: "DELETE",
         input: (input) => ({ params: { id: input.id } }),
         select: (data) => data,
-        invalidates: ["conversations.list"],
-        removeData: {
-          args: (_result, input) => [
-            input.id
-          ]
-        }
+        refresh: false
       }
     }
   }
@@ -57,4 +154,4 @@ function createAiChatQueryKeys(client, headers) {
   return createResourceQueryKeys(client, aiChatResources, headers);
 }
 
-export { aiChatResources, createAiChatQueryKeys };
+export { aiChatIdentityKey, aiChatResources, createAiChatQueryKeys };

package/dist/plugins/api/index.cjs

@@ -3,6 +3,7 @@
 const betterCall = require('better-call');
 const createEndpoint = require('../../packages/stack/src/plugins/api/create-endpoint.cjs');
 const db = require('@btst/db');
+const operation = require('../../packages/stack/src/plugins/api/operation.cjs');
 
 function defineBackendPlugin(plugin) {
   return plugin;
@@ -11,4 +12,7 @@ function defineBackendPlugin(plugin) {
 exports.createRouter = betterCall.createRouter;
 exports.createEndpoint = createEndpoint.createEndpoint;
 exports.createDbPlugin = db.createDbPlugin;
+exports.OperationHttpError = operation.OperationHttpError;
+exports.defineOperation = operation.defineOperation;
+exports.definePassthroughOperation = operation.definePassthroughOperation;
 exports.defineBackendPlugin = defineBackendPlugin;

package/dist/plugins/api/index.d.cts

@@ -1,10 +1,15 @@
-import { B as BackendPlugin } from '../../shared/stack.CBsp9rDM.cjs';
-export { C as ClientPlugin } from '../../shared/stack.CBsp9rDM.cjs';
+import { O as OperationRecord, B as BackendPlugin } from '../../shared/stack.DiuRuzIs.cjs';
+export { A as AnyOperation, C as ClientPlugin, a as ComposedEndpointInventoryEntry, D as DeepReadonly, I as InfrastructureRouteDeclaration, b as InfrastructureRouteInventory, e as Operation, f as OperationAccess, g as OperationApi, h as OperationContext, i as OperationData, j as OperationErrorContext, k as OperationHttpError, l as OperationPermissionRequest, m as OperationResultMode, n as RouteOperation, o as RouteOperationApi, d as defineOperation, c as definePassthroughOperation } from '../../shared/stack.DiuRuzIs.cjs';
 import { createEndpoint as createEndpoint$1, Endpoint } from 'better-call';
 export { Endpoint, Router, createRouter } from 'better-call';
 export { DBAdapter as Adapter, DatabaseDefinition, DbPlugin, createDbPlugin } from '@btst/db';
 import '@btst/yar';
-import '../../shared/stack.C4_gEENS.cjs';
+import '@tanstack/react-query';
+import '../../authorization/server.cjs';
+import '../../authorization/index.cjs';
+import 'zod';
+import '../../shared/stack.CKXzdGiJ.cjs';
+import '../../shared/stack.BYMentwB.cjs';
 
 /** JSON-safe issue shape included in 400 validation error response bodies. */
 interface SerializedValidationIssue {
@@ -26,17 +31,7 @@ interface SerializedValidationIssue {
  */
 declare const createEndpoint: typeof createEndpoint$1;
 
-/**
- * Plugin utilities and types for building standalone plugins
- *
- * This module exports everything needed to create custom plugins
- * for BTST outside of this package.
- *
- * Note: Backend and Client plugins are separate to prevent SSR issues
- * and enable better code splitting. Import them separately:
- * - Backend: import type { BackendPlugin } from "@btst/stack/plugins/api"
- * - Client: import type { ClientPlugin } from "@btst/stack/plugins/client"
- */
+type IdentifiedBackendPlugin<TId extends string, TRoutes extends Record<string, Endpoint>, TRaw extends Record<string, (...args: any[]) => any>, TOperations extends OperationRecord> = BackendPlugin<TRoutes, TRaw, TOperations, TId>;
 
 /**
  * Helper to define a backend plugin with full type inference
@@ -44,7 +39,7 @@ declare const createEndpoint: typeof createEndpoint$1;
  * @example
  * ```ts
  * const messagesPlugin = defineBackendPlugin({
- *   name: "messages",
+ *   id: "messages",
  *   dbPlugin: createDbPlugin("messages", messagesSchema),
  *   routes: (adapter) => ({
  *     list: endpoint("/messages", { method: "GET" }, async () => { ... }),
@@ -55,9 +50,9 @@ declare const createEndpoint: typeof createEndpoint$1;
  * ```
  *
  * @template TRoutes - The exact shape of routes (auto-inferred from routes function)
- * @template TApi - The shape of the server-side api surface (auto-inferred from api factory)
+ * @template TRaw - The narrow lower-level server surface (auto-inferred from the raw factory)
  */
-declare function defineBackendPlugin<TRoutes extends Record<string, Endpoint> = Record<string, Endpoint>, TApi extends Record<string, (...args: any[]) => any> = never>(plugin: BackendPlugin<TRoutes, TApi>): BackendPlugin<TRoutes, TApi>;
+declare function defineBackendPlugin<const TId extends string, TRoutes extends Record<string, Endpoint> = Record<string, Endpoint>, TRaw extends Record<string, (...args: any[]) => any> = never, TOperations extends OperationRecord = never>(plugin: IdentifiedBackendPlugin<TId, TRoutes, TRaw, TOperations>): IdentifiedBackendPlugin<TId, TRoutes, TRaw, TOperations>;
 
-export { BackendPlugin, createEndpoint, defineBackendPlugin };
+export { BackendPlugin, OperationRecord, createEndpoint, defineBackendPlugin };
 export type { SerializedValidationIssue };

package/dist/plugins/api/index.d.mts

@@ -1,10 +1,15 @@
-import { B as BackendPlugin } from '../../shared/stack.BL5PvShn.mjs';
-export { C as ClientPlugin } from '../../shared/stack.BL5PvShn.mjs';
+import { O as OperationRecord, B as BackendPlugin } from '../../shared/stack.CfK5NKlK.mjs';
+export { A as AnyOperation, C as ClientPlugin, a as ComposedEndpointInventoryEntry, D as DeepReadonly, I as InfrastructureRouteDeclaration, b as InfrastructureRouteInventory, e as Operation, f as OperationAccess, g as OperationApi, h as OperationContext, i as OperationData, j as OperationErrorContext, k as OperationHttpError, l as OperationPermissionRequest, m as OperationResultMode, n as RouteOperation, o as RouteOperationApi, d as defineOperation, c as definePassthroughOperation } from '../../shared/stack.CfK5NKlK.mjs';
 import { createEndpoint as createEndpoint$1, Endpoint } from 'better-call';
 export { Endpoint, Router, createRouter } from 'better-call';
 export { DBAdapter as Adapter, DatabaseDefinition, DbPlugin, createDbPlugin } from '@btst/db';
 import '@btst/yar';
-import '../../shared/stack.C4_gEENS.mjs';
+import '@tanstack/react-query';
+import '../../authorization/server.mjs';
+import '../../authorization/index.mjs';
+import 'zod';
+import '../../shared/stack.CKXzdGiJ.mjs';
+import '../../shared/stack.BYMentwB.mjs';
 
 /** JSON-safe issue shape included in 400 validation error response bodies. */
 interface SerializedValidationIssue {
@@ -26,17 +31,7 @@ interface SerializedValidationIssue {
  */
 declare const createEndpoint: typeof createEndpoint$1;
 
-/**
- * Plugin utilities and types for building standalone plugins
- *
- * This module exports everything needed to create custom plugins
- * for BTST outside of this package.
- *
- * Note: Backend and Client plugins are separate to prevent SSR issues
- * and enable better code splitting. Import them separately:
- * - Backend: import type { BackendPlugin } from "@btst/stack/plugins/api"
- * - Client: import type { ClientPlugin } from "@btst/stack/plugins/client"
- */
+type IdentifiedBackendPlugin<TId extends string, TRoutes extends Record<string, Endpoint>, TRaw extends Record<string, (...args: any[]) => any>, TOperations extends OperationRecord> = BackendPlugin<TRoutes, TRaw, TOperations, TId>;
 
 /**
  * Helper to define a backend plugin with full type inference
@@ -44,7 +39,7 @@ declare const createEndpoint: typeof createEndpoint$1;
  * @example
  * ```ts
  * const messagesPlugin = defineBackendPlugin({
- *   name: "messages",
+ *   id: "messages",
  *   dbPlugin: createDbPlugin("messages", messagesSchema),
  *   routes: (adapter) => ({
  *     list: endpoint("/messages", { method: "GET" }, async () => { ... }),
@@ -55,9 +50,9 @@ declare const createEndpoint: typeof createEndpoint$1;
  * ```
  *
  * @template TRoutes - The exact shape of routes (auto-inferred from routes function)
- * @template TApi - The shape of the server-side api surface (auto-inferred from api factory)
+ * @template TRaw - The narrow lower-level server surface (auto-inferred from the raw factory)
  */
-declare function defineBackendPlugin<TRoutes extends Record<string, Endpoint> = Record<string, Endpoint>, TApi extends Record<string, (...args: any[]) => any> = never>(plugin: BackendPlugin<TRoutes, TApi>): BackendPlugin<TRoutes, TApi>;
+declare function defineBackendPlugin<const TId extends string, TRoutes extends Record<string, Endpoint> = Record<string, Endpoint>, TRaw extends Record<string, (...args: any[]) => any> = never, TOperations extends OperationRecord = never>(plugin: IdentifiedBackendPlugin<TId, TRoutes, TRaw, TOperations>): IdentifiedBackendPlugin<TId, TRoutes, TRaw, TOperations>;
 
-export { BackendPlugin, createEndpoint, defineBackendPlugin };
+export { BackendPlugin, OperationRecord, createEndpoint, defineBackendPlugin };
 export type { SerializedValidationIssue };

package/dist/plugins/api/index.d.ts

@@ -1,10 +1,15 @@
-import { B as BackendPlugin } from '../../shared/stack.BqTR6qi2.js';
-export { C as ClientPlugin } from '../../shared/stack.BqTR6qi2.js';
+import { O as OperationRecord, B as BackendPlugin } from '../../shared/stack.0O62uXqP.js';
+export { A as AnyOperation, C as ClientPlugin, a as ComposedEndpointInventoryEntry, D as DeepReadonly, I as InfrastructureRouteDeclaration, b as InfrastructureRouteInventory, e as Operation, f as OperationAccess, g as OperationApi, h as OperationContext, i as OperationData, j as OperationErrorContext, k as OperationHttpError, l as OperationPermissionRequest, m as OperationResultMode, n as RouteOperation, o as RouteOperationApi, d as defineOperation, c as definePassthroughOperation } from '../../shared/stack.0O62uXqP.js';
 import { createEndpoint as createEndpoint$1, Endpoint } from 'better-call';
 export { Endpoint, Router, createRouter } from 'better-call';
 export { DBAdapter as Adapter, DatabaseDefinition, DbPlugin, createDbPlugin } from '@btst/db';
 import '@btst/yar';
-import '../../shared/stack.C4_gEENS.js';
+import '@tanstack/react-query';
+import '../../authorization/server.js';
+import '../../authorization/index.js';
+import 'zod';
+import '../../shared/stack.CKXzdGiJ.js';
+import '../../shared/stack.BYMentwB.js';
 
 /** JSON-safe issue shape included in 400 validation error response bodies. */
 interface SerializedValidationIssue {
@@ -26,17 +31,7 @@ interface SerializedValidationIssue {
  */
 declare const createEndpoint: typeof createEndpoint$1;
 
-/**
- * Plugin utilities and types for building standalone plugins
- *
- * This module exports everything needed to create custom plugins
- * for BTST outside of this package.
- *
- * Note: Backend and Client plugins are separate to prevent SSR issues
- * and enable better code splitting. Import them separately:
- * - Backend: import type { BackendPlugin } from "@btst/stack/plugins/api"
- * - Client: import type { ClientPlugin } from "@btst/stack/plugins/client"
- */
+type IdentifiedBackendPlugin<TId extends string, TRoutes extends Record<string, Endpoint>, TRaw extends Record<string, (...args: any[]) => any>, TOperations extends OperationRecord> = BackendPlugin<TRoutes, TRaw, TOperations, TId>;
 
 /**
  * Helper to define a backend plugin with full type inference
@@ -44,7 +39,7 @@ declare const createEndpoint: typeof createEndpoint$1;
  * @example
  * ```ts
  * const messagesPlugin = defineBackendPlugin({
- *   name: "messages",
+ *   id: "messages",
  *   dbPlugin: createDbPlugin("messages", messagesSchema),
  *   routes: (adapter) => ({
  *     list: endpoint("/messages", { method: "GET" }, async () => { ... }),
@@ -55,9 +50,9 @@ declare const createEndpoint: typeof createEndpoint$1;
  * ```
  *
  * @template TRoutes - The exact shape of routes (auto-inferred from routes function)
- * @template TApi - The shape of the server-side api surface (auto-inferred from api factory)
+ * @template TRaw - The narrow lower-level server surface (auto-inferred from the raw factory)
  */
-declare function defineBackendPlugin<TRoutes extends Record<string, Endpoint> = Record<string, Endpoint>, TApi extends Record<string, (...args: any[]) => any> = never>(plugin: BackendPlugin<TRoutes, TApi>): BackendPlugin<TRoutes, TApi>;
+declare function defineBackendPlugin<const TId extends string, TRoutes extends Record<string, Endpoint> = Record<string, Endpoint>, TRaw extends Record<string, (...args: any[]) => any> = never, TOperations extends OperationRecord = never>(plugin: IdentifiedBackendPlugin<TId, TRoutes, TRaw, TOperations>): IdentifiedBackendPlugin<TId, TRoutes, TRaw, TOperations>;
 
-export { BackendPlugin, createEndpoint, defineBackendPlugin };
+export { BackendPlugin, OperationRecord, createEndpoint, defineBackendPlugin };
 export type { SerializedValidationIssue };

package/dist/plugins/api/index.mjs

@@ -1,6 +1,7 @@
 export { createRouter } from 'better-call';
 export { createEndpoint } from '../../packages/stack/src/plugins/api/create-endpoint.mjs';
 export { createDbPlugin } from '@btst/db';
+export { OperationHttpError, defineOperation, definePassthroughOperation } from '../../packages/stack/src/plugins/api/operation.mjs';
 
 function defineBackendPlugin(plugin) {
   return plugin;

package/dist/plugins/blog/api/index.cjs

@@ -6,11 +6,12 @@ const mutations = require('../../../packages/stack/src/plugins/blog/api/mutation
 const serializers = require('../../../packages/stack/src/plugins/blog/api/serializers.cjs');
 const queryKeyDefs = require('../../../packages/stack/src/plugins/blog/api/query-key-defs.cjs');
 const plugins_blog_queryKeys = require('../query-keys.cjs');
+const plugins_blog_permissions = require('../permissions.cjs');
+const operations = require('../../../packages/stack/src/plugins/blog/api/operations.cjs');
+const lifecycleMigrations = require('../../../packages/stack/src/plugins/blog/api/lifecycle-migrations.cjs');
 
 
 
-exports.NextPreviousPostsQuerySchema = plugin.NextPreviousPostsQuerySchema;
-exports.PostListQuerySchema = plugin.PostListQuerySchema;
 exports.blogBackendPlugin = plugin.blogBackendPlugin;
 exports.getAllPosts = getters.getAllPosts;
 exports.getAllTags = getters.getAllTags;
@@ -22,3 +23,9 @@ exports.serializePost = serializers.serializePost;
 exports.serializeTag = serializers.serializeTag;
 exports.BLOG_QUERY_KEYS = queryKeyDefs.BLOG_QUERY_KEYS;
 exports.createBlogQueryKeys = plugins_blog_queryKeys.createBlogQueryKeys;
+exports.blogPermissions = plugins_blog_permissions.blogPermissions;
+exports.CreatePostOperationInputSchema = operations.CreatePostOperationInputSchema;
+exports.NextPreviousPostsQuerySchema = operations.NextPreviousPostsQuerySchema;
+exports.PostListQuerySchema = operations.PostListQuerySchema;
+exports.UpdatePostOperationInputSchema = operations.UpdatePostOperationInputSchema;
+exports.BLOG_LIFECYCLE_HOOK_MIGRATIONS = lifecycleMigrations.BLOG_LIFECYCLE_HOOK_MIGRATIONS;

package/dist/plugins/blog/api/index.d.cts

@@ -1,12 +1,125 @@
-export { B as BLOG_QUERY_KEYS, j as BlogApiContext, m as BlogApiRouter, k as BlogBackendHooks, h as BlogRouteKey, C as CreatePostInput, N as NextPreviousPostsQuerySchema, P as PostListParams, i as PostListQuerySchema, c as PostListResult, U as UpdatePostInput, l as blogBackendPlugin, f as createBlogQueryKeys, d as createPost, e as deletePost, g as getAllPosts, b as getAllTags, a as getPostBySlug, u as updatePost } from '../../../shared/stack.H5B8miAV.cjs';
+export { B as BLOG_QUERY_KEYS, i as BlogApiRouter, k as BlogBackendHooks, f as BlogBackendOptions, l as BlogCreateErrorContext, m as BlogCreateOperationContext, n as BlogCreateResultContext, o as BlogDeleteErrorContext, p as BlogDeleteOperationContext, q as BlogDeleteResultContext, r as BlogListErrorContext, s as BlogListOperationContext, t as BlogListResultContext, u as BlogNextPreviousErrorContext, v as BlogNextPreviousOperationContext, w as BlogNextPreviousResultContext, e as BlogRouteKey, x as BlogUpdateErrorContext, y as BlogUpdateOperationContext, z as BlogUpdateResultContext, C as CreatePostOperationInputSchema, N as NextPreviousPostsQuerySchema, P as PostListParams, j as PostListQuerySchema, c as PostListResult, S as SerializedNextPreviousPostsResult, A as SerializedPostListResult, U as UpdatePostOperationInputSchema, h as blogBackendPlugin, d as createBlogQueryKeys, g as getAllPosts, b as getAllTags, a as getPostBySlug } from '../../../shared/stack.BOZRaVpu.cjs';
+import { DBAdapter } from '@btst/db';
 import { P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from '../../../shared/stack.Dsatjh0B.cjs';
+export { blogPermissions } from '../permissions.cjs';
 import '@btst/stack/plugins/client';
 import 'zod';
-import '../../../shared/stack.B0muOwUF.cjs';
+import '../../../shared/stack.Csi-4Mgz.cjs';
 import '@btst/stack/plugins/api';
-import '@btst/db';
+import '../../../authorization/index.cjs';
+import 'zod/v4/core';
 import 'better-call';
 import '@tanstack/react-query';
+import '@btst/stack/authorization';
+
+/**
+ * Removed Blog lifecycle names and their canonical v3 replacements.
+ *
+ * This structured inventory is the source for migration documentation and
+ * repository guards. Names absent from this map did not change.
+ */
+declare const BLOG_LIFECYCLE_HOOK_MIGRATIONS: Readonly<{
+    readonly onBeforeNextPreviousPosts: "onBeforeGetNextPreviousPosts";
+    readonly onPostsRead: "onAfterListPosts";
+    readonly onPostCreated: "onAfterCreatePost";
+    readonly onPostUpdated: "onAfterUpdatePost";
+    readonly onPostDeleted: "onAfterDeletePost";
+    readonly onNextPreviousPostsRead: "onAfterGetNextPreviousPosts";
+    readonly onListPostsError: "onErrorListPosts";
+    readonly onNextPreviousPostsError: "onErrorGetNextPreviousPosts";
+    readonly onCreatePostError: "onErrorCreatePost";
+    readonly onUpdatePostError: "onErrorUpdatePost";
+    readonly onDeletePostError: "onErrorDeletePost";
+}>;
+
+type TagInput = {
+    name: string;
+} | {
+    id: string;
+    name: string;
+    slug: string;
+};
+/**
+ * Input for creating a new blog post.
+ * `slug` must already be slugified by the caller.
+ */
+interface CreatePostInput {
+    /** Trusted author identity assigned by the authorized operation. */
+    authorId?: string;
+    title: string;
+    content: string;
+    excerpt: string;
+    /** Pre-slugified URL slug — use {@link slugify} before passing. */
+    slug: string;
+    image?: string;
+    published?: boolean;
+    publishedAt?: Date;
+    createdAt?: Date;
+    updatedAt?: Date;
+    tags?: TagInput[];
+}
+/**
+ * Input for updating an existing blog post.
+ * If `slug` is provided it must already be slugified by the caller.
+ */
+interface UpdatePostInput {
+    title?: string;
+    content?: string;
+    excerpt?: string;
+    /** Pre-slugified URL slug — use {@link slugify} before passing. */
+    slug?: string;
+    image?: string;
+    published?: boolean;
+    publishedAt?: Date;
+    createdAt?: Date;
+    updatedAt?: Date;
+    tags?: TagInput[];
+}
+/** Optional atomic preconditions for a post update. */
+interface UpdatePostOptions {
+    /** Update only when the stored publish state still matches this value. */
+    expectedPublished?: boolean;
+}
+/**
+ * Create a new blog post with optional tag associations.
+ * Pure DB function — no hooks, no HTTP context. Safe for server-side and SSG use.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are NOT
+ * called. The caller is responsible for any access-control checks before
+ * invoking this function.
+ *
+ * @param adapter - The database adapter
+ * @param input - Post data; `slug` must be pre-slugified
+ */
+declare function createPost(adapter: DBAdapter, input: CreatePostInput): Promise<Post>;
+/**
+ * Update an existing blog post and reconcile its tag associations.
+ * Returns `null` if no post with the given `id` exists or an optional state
+ * precondition no longer matches.
+ * Pure DB function — no hooks, no HTTP context. Safe for server-side use.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are NOT
+ * called. The caller is responsible for any access-control checks before
+ * invoking this function.
+ *
+ * @param adapter - The database adapter
+ * @param id - The post ID to update
+ * @param input - Partial post data to apply; `slug` must be pre-slugified if provided
+ * @param options - Optional state that must still match when the write executes
+ */
+declare function updatePost(adapter: DBAdapter, id: string, input: UpdatePostInput, options?: UpdatePostOptions): Promise<Post | null>;
+/**
+ * Delete a blog post by ID.
+ * Pure DB function — no hooks, no HTTP context. Safe for server-side use.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are NOT
+ * called. The caller is responsible for any access-control checks before
+ * invoking this function.
+ *
+ * @param adapter - The database adapter
+ * @param id - The post ID to delete
+ */
+declare function deletePost(adapter: DBAdapter, id: string): Promise<void>;
 
 /**
  * Serialize a Tag for SSR/SSG use (convert dates to strings).
@@ -21,4 +134,5 @@ declare function serializePost(post: Post & {
     tags: Tag[];
 }): SerializedPost;
 
-export { serializePost, serializeTag };
+export { BLOG_LIFECYCLE_HOOK_MIGRATIONS, createPost, deletePost, serializePost, serializeTag, updatePost };
+export type { CreatePostInput, UpdatePostInput, UpdatePostOptions };