@mx-space/byline-api-client 0.1.2 → 0.2.0

package/README.md

@@ -82,8 +82,10 @@ const admin = createClient({ endpoint, apiKey: process.env.BYLINE_API_KEY })
 
 `posts.create` and `posts.revise` go through the draft and publish-job flow the admin
 uses: they save a draft revision, start a publish job and wait for it. `revise`
-branches from the post's published revision, so fields you omit keep their current
-values.
+writes into the post's working copy on top of its published revision, so fields you
+omit keep their current values. When it publishes, `revise` refuses with
+`DRAFT_WORKING_COPY_AHEAD` (409) if someone has unpublished changes in the working
+copy; pass `{ publish: false }` to write into the working copy without publishing.
 
 ```ts
 const { postId } = await admin.posts.create(

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region src/case.ts
+// src/case.ts
 const isPlainObject = (value) => Object.prototype.toString.call(value) === "[object Object]";
 const camelcase = (key) => key.replaceAll(/_([\da-z])/gi, (_, char) => char.toUpperCase());
 const splitPath = (path) => path.replaceAll("[]", ".[]").split(".").filter((segment) => segment.length > 0);
@@ -38,8 +38,7 @@ const walk = (value, tree) => {
 	return out;
 };
 const camelcaseKeys = (value, preservePaths = []) => walk(value, buildTree(preservePaths));
-//#endregion
-//#region src/error.ts
+// src/error.ts
 var BylineApiError = class extends Error {
 	status;
 	code;
@@ -55,8 +54,7 @@ var BylineApiError = class extends Error {
 	}
 };
 const isBylineApiError = (error, code) => error instanceof BylineApiError && (code === void 0 || error.code === code);
-//#endregion
-//#region src/http.ts
+// src/http.ts
 const ENVELOPE_KEYS = /* @__PURE__ */ new Set(["data", "meta"]);
 const isEnvelope = (body) => !!body && typeof body === "object" && !Array.isArray(body) && "data" in body && Object.keys(body).every((key) => ENVELOPE_KEYS.has(key));
 const isBinaryBody = (body) => typeof FormData !== "undefined" && body instanceof FormData || typeof Blob !== "undefined" && body instanceof Blob || body instanceof ArrayBuffer || body instanceof URLSearchParams || typeof body === "string";
@@ -125,8 +123,7 @@ var HttpCore = class {
 		return new BylineApiError(status, "HTTP_ERROR", typeof payload === "string" && payload ? payload.slice(0, 500) : `Request failed with status ${status}`, path);
 	}
 };
-//#endregion
-//#region src/resources/authors.ts
+// src/resources/authors.ts
 var AuthorsResource = class {
 	http;
 	constructor(http) {
@@ -151,8 +148,7 @@ var AuthorsResource = class {
 		return this.http.request("GET", `/authors/${encodeURIComponent(idOrUsername)}`);
 	}
 };
-//#endregion
-//#region src/resources/content.ts
+// src/resources/content.ts
 const CATALOG_PRESERVE = ["components[].propsSchema"];
 var CategoriesResource = class {
 	http;
@@ -247,8 +243,7 @@ var FilesResource = class {
 		});
 	}
 };
-//#endregion
-//#region src/resources/drafts.ts
+// src/resources/drafts.ts
 var DraftsResource = class {
 	http;
 	constructor(http) {
@@ -273,8 +268,7 @@ var DraftsResource = class {
 		return this.http.request("DELETE", `/drafts/${id}`);
 	}
 };
-//#endregion
-//#region src/resources/posts.ts
+// src/resources/posts.ts
 const POST_PRESERVE = ["meta"];
 const POST_LIST_PRESERVE = ["[].meta"];
 const DRAFT_CORE_KEYS = /* @__PURE__ */ new Set([
@@ -390,7 +384,8 @@ var PostsResource = class {
 			refType: "post",
 			refId: id,
 			baseRevisionId: base.id,
-			data: mergeSnapshot(base, toDraftData(input))
+			data: mergeSnapshot(base, toDraftData(input)),
+			...options.publish === false ? {} : { ifInSync: true }
 		});
 		return this.finish(draft, options);
 	}
@@ -404,7 +399,6 @@ var PostsResource = class {
 			branchId: draft.id,
 			revisionId: draft.headRevisionId,
 			expectedPublishedRevisionId: draft.document.publishedRevisionId,
-			confirmDiverged: draft.relationToPublished === "descendant" || draft.relationToPublished === "diverged",
 			aiResources: options.aiResources,
 			regenerateLockedTranslations: options.regenerateLockedTranslations
 		}, options);
@@ -415,8 +409,7 @@ var PostsResource = class {
 		};
 	}
 };
-//#endregion
-//#region src/resources/tasks.ts
+// src/resources/tasks.ts
 const TERMINAL = /* @__PURE__ */ new Set([
 	"completed",
 	"partial_failed",
@@ -469,8 +462,7 @@ var PublishJobsResource = class {
 		return task;
 	}
 };
-//#endregion
-//#region src/resources/users.ts
+// src/resources/users.ts
 var UsersResource = class {
 	http;
 	constructor(http) {
@@ -547,8 +539,7 @@ var InvitesResource = class {
 		return this.http.request("POST", `/invites/${encodeURIComponent(token)}/accept`, { body: input });
 	}
 };
-//#endregion
-//#region src/client.ts
+// src/client.ts
 var BylineClient = class {
 	http;
 	posts;
@@ -578,7 +569,6 @@ var BylineClient = class {
 	}
 };
 const createClient = (options) => new BylineClient(options);
-//#endregion
 exports.BylineApiError = BylineApiError;
 exports.BylineClient = BylineClient;
 exports.HttpCore = HttpCore;

package/dist/index.d.cts

@@ -1,7 +1,4 @@
-//#region src/case.d.ts
-declare const camelcaseKeys: <T>(value: unknown, preservePaths?: readonly string[]) => T;
-//#endregion
-//#region src/types.d.ts
+export declare const camelcaseKeys: <T>(value: unknown, preservePaths?: readonly string[]) => T;
 interface ApiResponse<T, M = Record<string, unknown>> {
   data: T;
   meta?: M;
@@ -172,12 +169,13 @@ interface PostImage {
   [key: string]: unknown;
 }
 interface Post {
+  publicAt?: string | null;
   id: string;
   title: string;
   slug: string;
   text: string;
   content: string | null;
-  contentFormat: string;
+  contentFormat: 'lexical';
   summary: string | null;
   images: PostImage[] | null;
   meta: Record<string, unknown> | null;
@@ -195,7 +193,7 @@ interface Post {
   seo: PostSeo | null;
   [key: string]: unknown;
 }
-type PostSortKey = 'createdAt' | 'modifiedAt' | 'pinAt';
+type PostSortKey = 'createdAt' | 'modifiedAt' | 'pinAt' | 'publicAt';
 interface PostListQuery {
   page?: number;
   size?: number;
@@ -208,6 +206,7 @@ interface PostListQuery {
   lang?: string;
 }
 interface PostPatch {
+  publicAt?: string | null;
   categoryId?: string;
   pinAt?: string | null;
   authors?: string[];
@@ -216,6 +215,7 @@ interface PostPatch {
   seo?: PostSeo | null;
 }
 interface PostWriteInput {
+  publicAt?: string | null;
   title: string;
   content: string | LexicalEditorState;
   text?: string;
@@ -234,10 +234,9 @@ interface PostWriteInput {
   createdAt?: string;
 }
 type DraftRefType = 'post';
-type RevisionRelation = 'same' | 'ancestor' | 'descendant' | 'diverged';
 interface RevisionSnapshot {
   content: string | null;
-  contentFormat: string;
+  contentFormat: 'lexical';
   images: unknown[] | null;
   meta: Record<string, unknown> | null;
   text: string;
@@ -256,9 +255,14 @@ interface ContentDocument {
   refType: DraftRefType;
   publishedRevisionId: string | null;
   publishAiResources: PublishAiResourceRequest[] | null;
+  aiSeo: {
+    description: string;
+    sourceHash: string;
+  } | null;
   createdAt: string;
   updatedAt: string | null;
 }
+type DraftRelation = 'ahead' | 'fresh' | 'in_sync';
 interface DraftBranch {
   id: string;
   documentId: string;
@@ -269,7 +273,7 @@ interface DraftBranch {
   headRevision: ContentRevision;
   baseRevision: ContentRevision;
   publishedRevision: ContentRevision | null;
-  relationToPublished: RevisionRelation | null;
+  relation: DraftRelation;
   createdAt: string;
   updatedAt: string | null;
 }
@@ -293,8 +297,9 @@ interface CreateDraftInput {
   refId?: string;
   baseRevisionId?: string | null;
   data: DraftWriteData;
+  ifInSync?: boolean;
 }
-type PublishAiResource = 'insights' | 'summary' | 'translation' | 'tts';
+type PublishAiResource = 'insights' | 'seo' | 'summary' | 'translation' | 'tts';
 interface PublishAiResourceRequest {
   resource: PublishAiResource;
   mode: 'sync' | 'async';
@@ -343,7 +348,7 @@ interface Translation {
   summary: string | null;
   tags: string[];
   content: string | null;
-  contentFormat: string | null;
+  contentFormat: 'lexical' | null;
   isLocked: boolean;
   aiModel: string | null;
   aiProvider: string | null;
@@ -414,8 +419,6 @@ interface UploadedFile {
   storageBackend?: string;
   storageKey?: string;
 }
-//#endregion
-//#region src/http.d.ts
 type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
 type QueryValue = string | number | boolean | null | undefined | ReadonlyArray<string | number>;
 interface ClientOptions {
@@ -434,7 +437,7 @@ interface RequestOptions {
   preserve?: readonly string[];
   signal?: AbortSignal;
 }
-declare class HttpCore {
+export declare class HttpCore {
   private readonly options;
   readonly endpoint: string;
   private readonly fetchImpl;
@@ -445,8 +448,6 @@ declare class HttpCore {
   private transform;
   private toError;
 }
-//#endregion
-//#region src/resources/authors.d.ts
 declare class AuthorsResource {
   private readonly http;
   constructor(http: HttpCore);
@@ -454,8 +455,6 @@ declare class AuthorsResource {
   listAll(): Promise<Author[]>;
   get(idOrUsername: string): Promise<ApiResponse<Author, Record<string, unknown>>>;
 }
-//#endregion
-//#region src/resources/content.d.ts
 declare class CategoriesResource {
   private readonly http;
   constructor(http: HttpCore);
@@ -509,8 +508,6 @@ declare class FilesResource {
     immutable?: boolean;
   }): Promise<ApiResponse<UploadedFile, Record<string, unknown>>>;
 }
-//#endregion
-//#region src/resources/drafts.d.ts
 declare class DraftsResource {
   private readonly http;
   constructor(http: HttpCore);
@@ -530,8 +527,6 @@ declare class DraftsResource {
   }): Promise<ApiResponse<DraftBranch, Record<string, unknown>>>;
   delete(id: string): Promise<ApiResponse<void, Record<string, unknown>>>;
 }
-//#endregion
-//#region src/resources/tasks.d.ts
 interface WaitForTaskOptions {
   intervalMs?: number;
   timeoutMs?: number;
@@ -553,8 +548,6 @@ declare class PublishJobsResource {
     result: PublishTaskResult;
   }>;
 }
-//#endregion
-//#region src/resources/posts.d.ts
 interface PostSaveOptions extends WaitForTaskOptions {
   publish?: boolean;
   aiResources?: Array<PublishAiResource | PublishAiResourceRequest>;
@@ -565,7 +558,7 @@ interface PostSaveResult {
   postId: string | null;
   taskId: string | null;
 }
-declare const toDraftData: (input: Partial<PostWriteInput>) => DraftWriteData;
+export declare const toDraftData: (input: Partial<PostWriteInput>) => DraftWriteData;
 declare class PostsResource {
   private readonly http;
   private readonly drafts;
@@ -599,8 +592,6 @@ declare class PostsResource {
   revise(id: string, input: Partial<PostWriteInput>, options?: PostSaveOptions): Promise<PostSaveResult>;
   private finish;
 }
-//#endregion
-//#region src/resources/users.d.ts
 declare class UsersResource {
   private readonly http;
   constructor(http: HttpCore);
@@ -630,9 +621,7 @@ declare class InvitesResource {
   get(token: string): Promise<ApiResponse<PublicInvite, Record<string, unknown>>>;
   accept(token: string, input: AcceptInviteInput): Promise<ApiResponse<UserDetail, Record<string, unknown>>>;
 }
-//#endregion
-//#region src/client.d.ts
-declare class BylineClient {
+export declare class BylineClient {
   readonly http: HttpCore;
   readonly posts: PostsResource;
   readonly drafts: DraftsResource;
@@ -647,10 +636,8 @@ declare class BylineClient {
   readonly files: FilesResource;
   constructor(options: ClientOptions);
 }
-declare const createClient: (options: ClientOptions) => BylineClient;
-//#endregion
-//#region src/error.d.ts
-declare class BylineApiError extends Error {
+export declare const createClient: (options: ClientOptions) => BylineClient;
+export declare class BylineApiError extends Error {
   readonly status: number;
   readonly code: string;
   readonly path: string;
@@ -658,6 +645,5 @@ declare class BylineApiError extends Error {
   readonly name = "BylineApiError";
   constructor(status: number, code: string, message: string, path: string, details?: unknown | undefined);
 }
-declare const isBylineApiError: (error: unknown, code?: string) => error is BylineApiError;
-//#endregion
-export { type AcceptInviteInput, type AllowLoginResult, type ApiResponse, type ArticleTranslationMeta, type Author, type AuthorListQuery, type AuthorsResource, BylineApiError, BylineClient, type CategoriesResource, type Category, type CategorySummary, type ClientOptions, type ContentDocument, type ContentRevision, type CreateDraftInput, type CreateInviteInput, type CreatePublishJobInput, type CreatedInvite, type DraftBranch, type DraftRefType, type DraftWriteData, type DraftsResource, type DynamicComponent, type DynamicComponentCatalog, type DynamicComponentsResource, type EntryTranslationMeta, type FileType, type FilesResource, HttpCore, type HttpMethod, type InitUserInput, type Invite, type InviteUserInput, type InvitesResource, type LexicalEditorState, type ManualTranslationInput, type PaginatedMeta, type Pagination, type Post, type PostImage, type PostListQuery, type PostPatch, type PostResponseMeta, type PostSaveOptions, type PostSaveResult, type PostSeo, type PostSortKey, type PostWriteInput, type PostsResource, type ProfileOnlyUserInput, type PublicAuthor, type PublicInvite, type PublishAiResource, type PublishAiResourceRequest, type PublishJobsResource, type PublishTaskResult, type QueryValue, type RegisterDynamicComponentInput, type RequestOptions, type RevisionRelation, type RevisionSnapshot, type Task, type TaskRef, type TaskStatus, type TasksResource, type Translation, type TranslationPatch, type TranslationTaskInput, type TranslationTaskResult, type TranslationsResource, type UpdateDynamicComponentInput, type UploadedFile, type UserDetail, type UserListQuery, type UserListStatus, type UserProfileInput, type UsersResource, type VersionContext, type WaitForTaskOptions, camelcaseKeys, createClient, isBylineApiError, toDraftData };
+export declare const isBylineApiError: (error: unknown, code?: string) => error is BylineApiError;
+export type { AcceptInviteInput, AllowLoginResult, ApiResponse, ArticleTranslationMeta, Author, AuthorListQuery, AuthorsResource, CategoriesResource, Category, CategorySummary, ClientOptions, ContentDocument, ContentRevision, CreateDraftInput, CreateInviteInput, CreatePublishJobInput, CreatedInvite, DraftBranch, DraftRefType, DraftRelation, DraftWriteData, DraftsResource, DynamicComponent, DynamicComponentCatalog, DynamicComponentsResource, EntryTranslationMeta, FileType, FilesResource, HttpMethod, InitUserInput, Invite, InviteUserInput, InvitesResource, LexicalEditorState, ManualTranslationInput, PaginatedMeta, Pagination, Post, PostImage, PostListQuery, PostPatch, PostResponseMeta, PostSaveOptions, PostSaveResult, PostSeo, PostSortKey, PostWriteInput, PostsResource, ProfileOnlyUserInput, PublicAuthor, PublicInvite, PublishAiResource, PublishAiResourceRequest, PublishJobsResource, PublishTaskResult, QueryValue, RegisterDynamicComponentInput, RequestOptions, RevisionSnapshot, Task, TaskRef, TaskStatus, TasksResource, Translation, TranslationPatch, TranslationTaskInput, TranslationTaskResult, TranslationsResource, UpdateDynamicComponentInput, UploadedFile, UserDetail, UserListQuery, UserListStatus, UserProfileInput, UsersResource, VersionContext, WaitForTaskOptions };

package/dist/index.d.ts

@@ -1,7 +1,4 @@
-//#region src/case.d.ts
-declare const camelcaseKeys: <T>(value: unknown, preservePaths?: readonly string[]) => T;
-//#endregion
-//#region src/types.d.ts
+export declare const camelcaseKeys: <T>(value: unknown, preservePaths?: readonly string[]) => T;
 interface ApiResponse<T, M = Record<string, unknown>> {
   data: T;
   meta?: M;
@@ -172,12 +169,13 @@ interface PostImage {
   [key: string]: unknown;
 }
 interface Post {
+  publicAt?: string | null;
   id: string;
   title: string;
   slug: string;
   text: string;
   content: string | null;
-  contentFormat: string;
+  contentFormat: 'lexical';
   summary: string | null;
   images: PostImage[] | null;
   meta: Record<string, unknown> | null;
@@ -195,7 +193,7 @@ interface Post {
   seo: PostSeo | null;
   [key: string]: unknown;
 }
-type PostSortKey = 'createdAt' | 'modifiedAt' | 'pinAt';
+type PostSortKey = 'createdAt' | 'modifiedAt' | 'pinAt' | 'publicAt';
 interface PostListQuery {
   page?: number;
   size?: number;
@@ -208,6 +206,7 @@ interface PostListQuery {
   lang?: string;
 }
 interface PostPatch {
+  publicAt?: string | null;
   categoryId?: string;
   pinAt?: string | null;
   authors?: string[];
@@ -216,6 +215,7 @@ interface PostPatch {
   seo?: PostSeo | null;
 }
 interface PostWriteInput {
+  publicAt?: string | null;
   title: string;
   content: string | LexicalEditorState;
   text?: string;
@@ -234,10 +234,9 @@ interface PostWriteInput {
   createdAt?: string;
 }
 type DraftRefType = 'post';
-type RevisionRelation = 'same' | 'ancestor' | 'descendant' | 'diverged';
 interface RevisionSnapshot {
   content: string | null;
-  contentFormat: string;
+  contentFormat: 'lexical';
   images: unknown[] | null;
   meta: Record<string, unknown> | null;
   text: string;
@@ -256,9 +255,14 @@ interface ContentDocument {
   refType: DraftRefType;
   publishedRevisionId: string | null;
   publishAiResources: PublishAiResourceRequest[] | null;
+  aiSeo: {
+    description: string;
+    sourceHash: string;
+  } | null;
   createdAt: string;
   updatedAt: string | null;
 }
+type DraftRelation = 'ahead' | 'fresh' | 'in_sync';
 interface DraftBranch {
   id: string;
   documentId: string;
@@ -269,7 +273,7 @@ interface DraftBranch {
   headRevision: ContentRevision;
   baseRevision: ContentRevision;
   publishedRevision: ContentRevision | null;
-  relationToPublished: RevisionRelation | null;
+  relation: DraftRelation;
   createdAt: string;
   updatedAt: string | null;
 }
@@ -293,8 +297,9 @@ interface CreateDraftInput {
   refId?: string;
   baseRevisionId?: string | null;
   data: DraftWriteData;
+  ifInSync?: boolean;
 }
-type PublishAiResource = 'insights' | 'summary' | 'translation' | 'tts';
+type PublishAiResource = 'insights' | 'seo' | 'summary' | 'translation' | 'tts';
 interface PublishAiResourceRequest {
   resource: PublishAiResource;
   mode: 'sync' | 'async';
@@ -343,7 +348,7 @@ interface Translation {
   summary: string | null;
   tags: string[];
   content: string | null;
-  contentFormat: string | null;
+  contentFormat: 'lexical' | null;
   isLocked: boolean;
   aiModel: string | null;
   aiProvider: string | null;
@@ -414,8 +419,6 @@ interface UploadedFile {
   storageBackend?: string;
   storageKey?: string;
 }
-//#endregion
-//#region src/http.d.ts
 type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
 type QueryValue = string | number | boolean | null | undefined | ReadonlyArray<string | number>;
 interface ClientOptions {
@@ -434,7 +437,7 @@ interface RequestOptions {
   preserve?: readonly string[];
   signal?: AbortSignal;
 }
-declare class HttpCore {
+export declare class HttpCore {
   private readonly options;
   readonly endpoint: string;
   private readonly fetchImpl;
@@ -445,8 +448,6 @@ declare class HttpCore {
   private transform;
   private toError;
 }
-//#endregion
-//#region src/resources/authors.d.ts
 declare class AuthorsResource {
   private readonly http;
   constructor(http: HttpCore);
@@ -454,8 +455,6 @@ declare class AuthorsResource {
   listAll(): Promise<Author[]>;
   get(idOrUsername: string): Promise<ApiResponse<Author, Record<string, unknown>>>;
 }
-//#endregion
-//#region src/resources/content.d.ts
 declare class CategoriesResource {
   private readonly http;
   constructor(http: HttpCore);
@@ -509,8 +508,6 @@ declare class FilesResource {
     immutable?: boolean;
   }): Promise<ApiResponse<UploadedFile, Record<string, unknown>>>;
 }
-//#endregion
-//#region src/resources/drafts.d.ts
 declare class DraftsResource {
   private readonly http;
   constructor(http: HttpCore);
@@ -530,8 +527,6 @@ declare class DraftsResource {
   }): Promise<ApiResponse<DraftBranch, Record<string, unknown>>>;
   delete(id: string): Promise<ApiResponse<void, Record<string, unknown>>>;
 }
-//#endregion
-//#region src/resources/tasks.d.ts
 interface WaitForTaskOptions {
   intervalMs?: number;
   timeoutMs?: number;
@@ -553,8 +548,6 @@ declare class PublishJobsResource {
     result: PublishTaskResult;
   }>;
 }
-//#endregion
-//#region src/resources/posts.d.ts
 interface PostSaveOptions extends WaitForTaskOptions {
   publish?: boolean;
   aiResources?: Array<PublishAiResource | PublishAiResourceRequest>;
@@ -565,7 +558,7 @@ interface PostSaveResult {
   postId: string | null;
   taskId: string | null;
 }
-declare const toDraftData: (input: Partial<PostWriteInput>) => DraftWriteData;
+export declare const toDraftData: (input: Partial<PostWriteInput>) => DraftWriteData;
 declare class PostsResource {
   private readonly http;
   private readonly drafts;
@@ -599,8 +592,6 @@ declare class PostsResource {
   revise(id: string, input: Partial<PostWriteInput>, options?: PostSaveOptions): Promise<PostSaveResult>;
   private finish;
 }
-//#endregion
-//#region src/resources/users.d.ts
 declare class UsersResource {
   private readonly http;
   constructor(http: HttpCore);
@@ -630,9 +621,7 @@ declare class InvitesResource {
   get(token: string): Promise<ApiResponse<PublicInvite, Record<string, unknown>>>;
   accept(token: string, input: AcceptInviteInput): Promise<ApiResponse<UserDetail, Record<string, unknown>>>;
 }
-//#endregion
-//#region src/client.d.ts
-declare class BylineClient {
+export declare class BylineClient {
   readonly http: HttpCore;
   readonly posts: PostsResource;
   readonly drafts: DraftsResource;
@@ -647,10 +636,8 @@ declare class BylineClient {
   readonly files: FilesResource;
   constructor(options: ClientOptions);
 }
-declare const createClient: (options: ClientOptions) => BylineClient;
-//#endregion
-//#region src/error.d.ts
-declare class BylineApiError extends Error {
+export declare const createClient: (options: ClientOptions) => BylineClient;
+export declare class BylineApiError extends Error {
   readonly status: number;
   readonly code: string;
   readonly path: string;
@@ -658,6 +645,5 @@ declare class BylineApiError extends Error {
   readonly name = "BylineApiError";
   constructor(status: number, code: string, message: string, path: string, details?: unknown | undefined);
 }
-declare const isBylineApiError: (error: unknown, code?: string) => error is BylineApiError;
-//#endregion
-export { type AcceptInviteInput, type AllowLoginResult, type ApiResponse, type ArticleTranslationMeta, type Author, type AuthorListQuery, type AuthorsResource, BylineApiError, BylineClient, type CategoriesResource, type Category, type CategorySummary, type ClientOptions, type ContentDocument, type ContentRevision, type CreateDraftInput, type CreateInviteInput, type CreatePublishJobInput, type CreatedInvite, type DraftBranch, type DraftRefType, type DraftWriteData, type DraftsResource, type DynamicComponent, type DynamicComponentCatalog, type DynamicComponentsResource, type EntryTranslationMeta, type FileType, type FilesResource, HttpCore, type HttpMethod, type InitUserInput, type Invite, type InviteUserInput, type InvitesResource, type LexicalEditorState, type ManualTranslationInput, type PaginatedMeta, type Pagination, type Post, type PostImage, type PostListQuery, type PostPatch, type PostResponseMeta, type PostSaveOptions, type PostSaveResult, type PostSeo, type PostSortKey, type PostWriteInput, type PostsResource, type ProfileOnlyUserInput, type PublicAuthor, type PublicInvite, type PublishAiResource, type PublishAiResourceRequest, type PublishJobsResource, type PublishTaskResult, type QueryValue, type RegisterDynamicComponentInput, type RequestOptions, type RevisionRelation, type RevisionSnapshot, type Task, type TaskRef, type TaskStatus, type TasksResource, type Translation, type TranslationPatch, type TranslationTaskInput, type TranslationTaskResult, type TranslationsResource, type UpdateDynamicComponentInput, type UploadedFile, type UserDetail, type UserListQuery, type UserListStatus, type UserProfileInput, type UsersResource, type VersionContext, type WaitForTaskOptions, camelcaseKeys, createClient, isBylineApiError, toDraftData };
+export declare const isBylineApiError: (error: unknown, code?: string) => error is BylineApiError;
+export type { AcceptInviteInput, AllowLoginResult, ApiResponse, ArticleTranslationMeta, Author, AuthorListQuery, AuthorsResource, CategoriesResource, Category, CategorySummary, ClientOptions, ContentDocument, ContentRevision, CreateDraftInput, CreateInviteInput, CreatePublishJobInput, CreatedInvite, DraftBranch, DraftRefType, DraftRelation, DraftWriteData, DraftsResource, DynamicComponent, DynamicComponentCatalog, DynamicComponentsResource, EntryTranslationMeta, FileType, FilesResource, HttpMethod, InitUserInput, Invite, InviteUserInput, InvitesResource, LexicalEditorState, ManualTranslationInput, PaginatedMeta, Pagination, Post, PostImage, PostListQuery, PostPatch, PostResponseMeta, PostSaveOptions, PostSaveResult, PostSeo, PostSortKey, PostWriteInput, PostsResource, ProfileOnlyUserInput, PublicAuthor, PublicInvite, PublishAiResource, PublishAiResourceRequest, PublishJobsResource, PublishTaskResult, QueryValue, RegisterDynamicComponentInput, RequestOptions, RevisionSnapshot, Task, TaskRef, TaskStatus, TasksResource, Translation, TranslationPatch, TranslationTaskInput, TranslationTaskResult, TranslationsResource, UpdateDynamicComponentInput, UploadedFile, UserDetail, UserListQuery, UserListStatus, UserProfileInput, UsersResource, VersionContext, WaitForTaskOptions };

package/dist/index.js

@@ -1,4 +1,4 @@
-//#region src/case.ts
+// src/case.ts
 const isPlainObject = (value) => Object.prototype.toString.call(value) === "[object Object]";
 const camelcase = (key) => key.replaceAll(/_([\da-z])/gi, (_, char) => char.toUpperCase());
 const splitPath = (path) => path.replaceAll("[]", ".[]").split(".").filter((segment) => segment.length > 0);
@@ -37,8 +37,7 @@ const walk = (value, tree) => {
 	return out;
 };
 const camelcaseKeys = (value, preservePaths = []) => walk(value, buildTree(preservePaths));
-//#endregion
-//#region src/error.ts
+// src/error.ts
 var BylineApiError = class extends Error {
 	status;
 	code;
@@ -54,8 +53,7 @@ var BylineApiError = class extends Error {
 	}
 };
 const isBylineApiError = (error, code) => error instanceof BylineApiError && (code === void 0 || error.code === code);
-//#endregion
-//#region src/http.ts
+// src/http.ts
 const ENVELOPE_KEYS = /* @__PURE__ */ new Set(["data", "meta"]);
 const isEnvelope = (body) => !!body && typeof body === "object" && !Array.isArray(body) && "data" in body && Object.keys(body).every((key) => ENVELOPE_KEYS.has(key));
 const isBinaryBody = (body) => typeof FormData !== "undefined" && body instanceof FormData || typeof Blob !== "undefined" && body instanceof Blob || body instanceof ArrayBuffer || body instanceof URLSearchParams || typeof body === "string";
@@ -124,8 +122,7 @@ var HttpCore = class {
 		return new BylineApiError(status, "HTTP_ERROR", typeof payload === "string" && payload ? payload.slice(0, 500) : `Request failed with status ${status}`, path);
 	}
 };
-//#endregion
-//#region src/resources/authors.ts
+// src/resources/authors.ts
 var AuthorsResource = class {
 	http;
 	constructor(http) {
@@ -150,8 +147,7 @@ var AuthorsResource = class {
 		return this.http.request("GET", `/authors/${encodeURIComponent(idOrUsername)}`);
 	}
 };
-//#endregion
-//#region src/resources/content.ts
+// src/resources/content.ts
 const CATALOG_PRESERVE = ["components[].propsSchema"];
 var CategoriesResource = class {
 	http;
@@ -246,8 +242,7 @@ var FilesResource = class {
 		});
 	}
 };
-//#endregion
-//#region src/resources/drafts.ts
+// src/resources/drafts.ts
 var DraftsResource = class {
 	http;
 	constructor(http) {
@@ -272,8 +267,7 @@ var DraftsResource = class {
 		return this.http.request("DELETE", `/drafts/${id}`);
 	}
 };
-//#endregion
-//#region src/resources/posts.ts
+// src/resources/posts.ts
 const POST_PRESERVE = ["meta"];
 const POST_LIST_PRESERVE = ["[].meta"];
 const DRAFT_CORE_KEYS = /* @__PURE__ */ new Set([
@@ -389,7 +383,8 @@ var PostsResource = class {
 			refType: "post",
 			refId: id,
 			baseRevisionId: base.id,
-			data: mergeSnapshot(base, toDraftData(input))
+			data: mergeSnapshot(base, toDraftData(input)),
+			...options.publish === false ? {} : { ifInSync: true }
 		});
 		return this.finish(draft, options);
 	}
@@ -403,7 +398,6 @@ var PostsResource = class {
 			branchId: draft.id,
 			revisionId: draft.headRevisionId,
 			expectedPublishedRevisionId: draft.document.publishedRevisionId,
-			confirmDiverged: draft.relationToPublished === "descendant" || draft.relationToPublished === "diverged",
 			aiResources: options.aiResources,
 			regenerateLockedTranslations: options.regenerateLockedTranslations
 		}, options);
@@ -414,8 +408,7 @@ var PostsResource = class {
 		};
 	}
 };
-//#endregion
-//#region src/resources/tasks.ts
+// src/resources/tasks.ts
 const TERMINAL = /* @__PURE__ */ new Set([
 	"completed",
 	"partial_failed",
@@ -468,8 +461,7 @@ var PublishJobsResource = class {
 		return task;
 	}
 };
-//#endregion
-//#region src/resources/users.ts
+// src/resources/users.ts
 var UsersResource = class {
 	http;
 	constructor(http) {
@@ -546,8 +538,7 @@ var InvitesResource = class {
 		return this.http.request("POST", `/invites/${encodeURIComponent(token)}/accept`, { body: input });
 	}
 };
-//#endregion
-//#region src/client.ts
+// src/client.ts
 var BylineClient = class {
 	http;
 	posts;
@@ -577,5 +568,4 @@ var BylineClient = class {
 	}
 };
 const createClient = (options) => new BylineClient(options);
-//#endregion
 export { BylineApiError, BylineClient, HttpCore, camelcaseKeys, createClient, isBylineApiError, toDraftData };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mx-space/byline-api-client",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Typed fetch client for the Byline headless CMS API",
   "keywords": [
     "byline",
@@ -44,7 +44,7 @@
     "access": "public"
   },
   "devDependencies": {
-    "tsdown": "0.22.8",
+    "tsdown": "0.23.1",
     "typescript": "6.0.3",
     "vitest": "5.0.5"
   },