@antlur/backstage 1.1.0 → 1.2.1

package/dist/cjs/client.js

@@ -7,6 +7,7 @@ exports.BackstageClient = void 0;
 const axios_1 = __importDefault(require("axios"));
 const config_1 = require("./config");
 const alerts_1 = require("./endpoints/alerts");
+const blocks_1 = require("./endpoints/blocks");
 const events_1 = require("./endpoints/events");
 const locations_1 = require("./endpoints/locations");
 const menus_1 = require("./endpoints/menus");
@@ -64,6 +65,7 @@ class BackstageClient {
         });
         // Initialize service instances
         this.alerts = new alerts_1.AlertService(this);
+        this.blocks = new blocks_1.BlocksService(this);
         this.events = new events_1.EventService(this);
         this.locations = new locations_1.LocationService(this);
         this.menus = new menus_1.MenuService(this);

package/dist/cjs/endpoints/blocks.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlocksService = void 0;
+const base_1 = require("./base");
+class BlocksService extends base_1.BaseService {
+    async all() { }
+    async create({ name, slug, schema }) {
+        const res = await this.client.post("/blocks", { name, slug, schema });
+        return res.data;
+    }
+    async update(id, { name, slug, schema }) {
+        const res = await this.client.put(`/blocks/${id}`, { name, slug, schema });
+        return res.data;
+    }
+}
+exports.BlocksService = BlocksService;

package/dist/cjs/studio/define-block.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineBlock = defineBlock;
+function defineBlock(options) {
+    // Runtime validation
+    if (!options.name || typeof options.name !== "string") {
+        throw new Error("Block name is required and must be a string");
+    }
+    if (!options.slug || typeof options.slug !== "string") {
+        throw new Error("Block slug is required and must be a string");
+    }
+    if (!options.schema || typeof options.schema !== "object") {
+        throw new Error("Block schema is required and must be an object");
+    }
+    if (!options.component) {
+        throw new Error("Block component is required");
+    }
+    return options;
+}

package/dist/cjs/studio/define-field.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineField = defineField;
+function defineField(field) {
+    return field;
+}

package/dist/cjs/studio/define-schema.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineSchema = defineSchema;
+function defineSchema(schema) {
+    return schema;
+}

package/dist/cjs/studio/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./define-block"), exports);
+__exportStar(require("./define-field"), exports);
+__exportStar(require("./define-schema"), exports);

package/dist/cjs/studio/types/block.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/studio/types/field-values.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/studio/types/field.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// export interface Field<T extends FieldType = FieldType> {
+//   name: string;
+//   slug: string;
+//   type: FieldType;
+//   value?: FieldTypeToValue[T];
+//   placeholder?: string;
+//   required?: boolean;
+//   options?: Array<{ label: string; value: any }>;
+// }

package/dist/cjs/studio/types/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./block"), exports);
+__exportStar(require("./field"), exports);
+__exportStar(require("./field-values"), exports);

package/dist/cjs/types/index.js

@@ -27,3 +27,4 @@ __exportStar(require("./navigation"), exports);
 __exportStar(require("./page"), exports);
 __exportStar(require("./press"), exports);
 __exportStar(require("./website"), exports);
+__exportStar(require("../studio/types/index"), exports);

package/dist/esm/client.d.ts

@@ -1,6 +1,7 @@
 import { AxiosInstance, AxiosRequestConfig } from "axios";
 import { BackstageUserConfig } from "./config";
 import { AlertService } from "./endpoints/alerts";
+import { BlocksService } from "./endpoints/blocks";
 import { EventService } from "./endpoints/events";
 import { LocationService } from "./endpoints/locations";
 import { MenuService } from "./endpoints/menus";
@@ -11,6 +12,7 @@ import { WebsiteService } from "./endpoints/website";
 export declare class BackstageClient {
     private instance;
     readonly alerts: AlertService;
+    readonly blocks: BlocksService;
     readonly events: EventService;
     readonly locations: LocationService;
     readonly menus: MenuService;

package/dist/esm/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,aAAa,EAAE,kBAAkB,EAA6B,MAAM,OAAO,CAAC;AAC5F,OAAO,EAAmB,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAgB;IAGhC,SAAgB,MAAM,EAAE,YAAY,CAAC;IACrC,SAAgB,MAAM,EAAE,YAAY,CAAC;IACrC,SAAgB,SAAS,EAAE,eAAe,CAAC;IAC3C,SAAgB,KAAK,EAAE,WAAW,CAAC;IACnC,SAAgB,UAAU,EAAE,iBAAiB,CAAC;IAC9C,SAAgB,KAAK,EAAE,WAAW,CAAC;IACnC,SAAgB,KAAK,EAAE,YAAY,CAAC;IACpC,SAAgB,OAAO,EAAE,cAAc,CAAC;gBAE5B,MAAM,CAAC,EAAE,mBAAmB;IAoE3B,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKtE,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKvF,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKtF,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKxF,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAK/E,gBAAgB,IAAI,aAAa;CAGzC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,aAAa,EAAE,kBAAkB,EAA6B,MAAM,OAAO,CAAC;AAC5F,OAAO,EAAmB,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAgB;IAGhC,SAAgB,MAAM,EAAE,YAAY,CAAC;IACrC,SAAgB,MAAM,EAAE,aAAa,CAAC;IACtC,SAAgB,MAAM,EAAE,YAAY,CAAC;IACrC,SAAgB,SAAS,EAAE,eAAe,CAAC;IAC3C,SAAgB,KAAK,EAAE,WAAW,CAAC;IACnC,SAAgB,UAAU,EAAE,iBAAiB,CAAC;IAC9C,SAAgB,KAAK,EAAE,WAAW,CAAC;IACnC,SAAgB,KAAK,EAAE,YAAY,CAAC;IACpC,SAAgB,OAAO,EAAE,cAAc,CAAC;gBAE5B,MAAM,CAAC,EAAE,mBAAmB;IAqE3B,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKtE,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKvF,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKtF,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKxF,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAK/E,gBAAgB,IAAI,aAAa;CAGzC"}

package/dist/esm/client.js

@@ -1,6 +1,7 @@
 import axios from "axios";
 import { getGlobalConfig } from "./config";
 import { AlertService } from "./endpoints/alerts";
+import { BlocksService } from "./endpoints/blocks";
 import { EventService } from "./endpoints/events";
 import { LocationService } from "./endpoints/locations";
 import { MenuService } from "./endpoints/menus";
@@ -58,6 +59,7 @@ export class BackstageClient {
         });
         // Initialize service instances
         this.alerts = new AlertService(this);
+        this.blocks = new BlocksService(this);
         this.events = new EventService(this);
         this.locations = new LocationService(this);
         this.menus = new MenuService(this);

package/dist/esm/config.d.ts

@@ -1,8 +1,10 @@
 import { AxiosError } from "axios";
+import type { BlockDefinition } from "./studio/types";
 export interface BackstageUserConfig {
     accountId?: string | undefined;
     token?: string | undefined;
     baseURL?: string;
+    blocks?: BlockDefinition<any>[] | undefined;
     onError?: (error: AxiosError) => void;
 }
 export declare function defineConfig(config: BackstageUserConfig): BackstageUserConfig;

package/dist/esm/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAMnC,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CACvC;AAQD,wBAAgB,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,mBAAmB,CAM7E;AAED,wBAAgB,eAAe,IAAI,mBAAmB,CAGrD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAMtD,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,GAAG,SAAS,CAAC;IAC5C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CACvC;AAQD,wBAAgB,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,mBAAmB,CAM7E;AAED,wBAAgB,eAAe,IAAI,mBAAmB,CAGrD"}

package/dist/esm/endpoints/blocks.d.ts

@@ -0,0 +1,13 @@
+import { BaseService } from "./base";
+interface BlockParams {
+    name: string;
+    slug: string;
+    schema: any;
+}
+export declare class BlocksService extends BaseService {
+    all(): Promise<void>;
+    create({ name, slug, schema }: BlockParams): Promise<BlockParams>;
+    update(id: string, { name, slug, schema }: BlockParams): Promise<BlockParams>;
+}
+export {};
+//# sourceMappingURL=blocks.d.ts.map

package/dist/esm/endpoints/blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../../src/endpoints/blocks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,GAAG,CAAC;CACb;AAED,qBAAa,aAAc,SAAQ,WAAW;IACtC,GAAG;IAEH,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW;IAK1C,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW;CAI7D"}

package/dist/esm/endpoints/blocks.js

@@ -0,0 +1,12 @@
+import { BaseService } from "./base";
+export class BlocksService extends BaseService {
+    async all() { }
+    async create({ name, slug, schema }) {
+        const res = await this.client.post("/blocks", { name, slug, schema });
+        return res.data;
+    }
+    async update(id, { name, slug, schema }) {
+        const res = await this.client.put(`/blocks/${id}`, { name, slug, schema });
+        return res.data;
+    }
+}

package/dist/esm/studio/define-block.d.ts

@@ -0,0 +1,8 @@
+import { BlockSchema, BlockDefinition, BlockComponentProps } from "./types";
+export declare function defineBlock(options: {
+    name: string;
+    slug: string;
+    schema: BlockSchema<any>;
+    component: React.ComponentType<BlockComponentProps<typeof options.schema>>;
+}): BlockDefinition<typeof options.schema.fields>;
+//# sourceMappingURL=define-block.d.ts.map

package/dist/esm/studio/define-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-block.d.ts","sourceRoot":"","sources":["../../../src/studio/define-block.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE5E,wBAAgB,WAAW,CAAC,OAAO,EAAE;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC;IACzB,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,mBAAmB,CAAC,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;CAC5E,GAAG,eAAe,CAAC,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAmBhD"}

package/dist/esm/studio/define-block.js

@@ -0,0 +1,16 @@
+export function defineBlock(options) {
+    // Runtime validation
+    if (!options.name || typeof options.name !== "string") {
+        throw new Error("Block name is required and must be a string");
+    }
+    if (!options.slug || typeof options.slug !== "string") {
+        throw new Error("Block slug is required and must be a string");
+    }
+    if (!options.schema || typeof options.schema !== "object") {
+        throw new Error("Block schema is required and must be an object");
+    }
+    if (!options.component) {
+        throw new Error("Block component is required");
+    }
+    return options;
+}

package/dist/esm/studio/define-field.d.ts

@@ -0,0 +1,3 @@
+import { Field } from "./types";
+export declare function defineField<T extends Field>(field: T): T;
+//# sourceMappingURL=define-field.d.ts.map

package/dist/esm/studio/define-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-field.d.ts","sourceRoot":"","sources":["../../../src/studio/define-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,wBAAgB,WAAW,CAAC,CAAC,SAAS,KAAK,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAExD"}

package/dist/esm/studio/define-field.js

@@ -0,0 +1,3 @@
+export function defineField(field) {
+    return field;
+}

package/dist/esm/studio/define-schema.d.ts

@@ -0,0 +1,4 @@
+import { BlockSchema, Field } from "./types";
+export type SchemaFields = Record<string, Field>;
+export declare function defineSchema<T extends SchemaFields>(schema: BlockSchema<T>): BlockSchema<T>;
+//# sourceMappingURL=define-schema.d.ts.map

package/dist/esm/studio/define-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-schema.d.ts","sourceRoot":"","sources":["../../../src/studio/define-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAEjD,wBAAgB,YAAY,CAAC,CAAC,SAAS,YAAY,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,kBAE1E"}

package/dist/esm/studio/define-schema.js

@@ -0,0 +1,3 @@
+export function defineSchema(schema) {
+    return schema;
+}

package/dist/esm/studio/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./types";
+export * from "./define-block";
+export * from "./define-field";
+export * from "./define-schema";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/studio/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/studio/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AAExB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC"}

package/dist/esm/studio/index.js

@@ -0,0 +1,4 @@
+export * from "./types";
+export * from "./define-block";
+export * from "./define-field";
+export * from "./define-schema";

package/dist/esm/studio/types/block.d.ts

@@ -0,0 +1,31 @@
+import { Field, FieldType, FieldTypeToValue } from "./field";
+type FieldValues<T extends Record<string, Field>> = {
+    [K in keyof T]: T[K] extends {
+        type: infer Type;
+    } ? (Type extends FieldType ? FieldTypeToValue[Type] : never) : never;
+};
+export interface BlockSchema<TFields extends Record<string, Field>> {
+    fields: TFields;
+    properties?: BlockProperties;
+}
+export interface BlockDefinition<TFields extends Record<string, Field>> {
+    name: string;
+    slug: string;
+    schema: BlockSchema<TFields>;
+    component: React.ComponentType<BlockComponentProps<any>>;
+}
+export interface BlockProperties {
+    customClassName?: string;
+}
+export interface BuilderBlock<TSchema extends BlockSchema<Record<string, Field>>> {
+    id: string;
+    type: string;
+    fields: FieldValues<TSchema["fields"]>;
+    properties?: BlockProperties;
+}
+export interface BlockComponentProps<TSchema extends BlockSchema<Record<string, Field>>> {
+    block: BuilderBlock<TSchema>;
+    onFieldChange: (blockId: string, fieldName: keyof TSchema["fields"], value: any) => void;
+}
+export {};
+//# sourceMappingURL=block.d.ts.map

package/dist/esm/studio/types/block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block.d.ts","sourceRoot":"","sources":["../../../../src/studio/types/block.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE7D,KAAK,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI;KACjD,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;QAAE,IAAI,EAAE,MAAM,IAAI,CAAA;KAAE,GAAG,CAAC,IAAI,SAAS,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK;CACtH,CAAC;AAEF,MAAM,WAAW,WAAW,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAChE,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC7B,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,eAAe;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY,CAAC,OAAO,SAAS,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9E,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvC,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB,CAAC,OAAO,SAAS,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACrF,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;IAC7B,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;CAC1F"}

package/dist/esm/studio/types/block.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/studio/types/field-values.d.ts

@@ -0,0 +1,8 @@
+export interface Media {
+    id: string;
+    url: string;
+    width: number;
+    height: number;
+    alt: string;
+}
+//# sourceMappingURL=field-values.d.ts.map

package/dist/esm/studio/types/field-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-values.d.ts","sourceRoot":"","sources":["../../../../src/studio/types/field-values.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb"}

package/dist/esm/studio/types/field-values.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/studio/types/field.d.ts

@@ -0,0 +1,40 @@
+import { MediaItem } from "../../types";
+type Nullable<T> = T | null;
+export type FieldTypeToValue = {
+    boolean: Nullable<boolean>;
+    event_select: Nullable<string>;
+    form_select: Nullable<string>;
+    image: Nullable<MediaItem>;
+    image_list: Nullable<MediaItem[]>;
+    list_array: Nullable<string[]>;
+    media: Nullable<MediaItem>;
+    menu_select: Nullable<string>;
+    number: Nullable<number>;
+    press_select: Nullable<string>;
+    repeater: Nullable<any[]>;
+    rich_text: Nullable<string>;
+    separator: never;
+    spacer: never;
+    text: Nullable<string>;
+    textarea: Nullable<string>;
+    url: Nullable<string>;
+};
+export type FieldType = keyof FieldTypeToValue;
+export type BaseField = {
+    name: string;
+    slug: string;
+    placeholder?: string;
+    required?: boolean;
+    options?: Array<{
+        label: string;
+        value: any;
+    }>;
+};
+export type Field = {
+    [K in FieldType]: BaseField & {
+        type: K;
+        value?: FieldTypeToValue[K];
+    };
+}[FieldType];
+export {};
+//# sourceMappingURL=field.d.ts.map

package/dist/esm/studio/types/field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../../../src/studio/types/field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE5B,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3B,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/B,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9B,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC3B,UAAU,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;IAClC,UAAU,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/B,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC3B,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzB,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;IAC1B,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC5B,SAAS,EAAE,KAAK,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACvB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3B,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CACvB,CAAC;AACF,MAAM,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC;AAE/C,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;KACjB,CAAC,IAAI,SAAS,GAAG,SAAS,GAAG;QAC5B,IAAI,EAAE,CAAC,CAAC;QACR,KAAK,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;KAC7B;CACF,CAAC,SAAS,CAAC,CAAC"}

package/dist/esm/studio/types/field.js

@@ -0,0 +1,10 @@
+export {};
+// export interface Field<T extends FieldType = FieldType> {
+//   name: string;
+//   slug: string;
+//   type: FieldType;
+//   value?: FieldTypeToValue[T];
+//   placeholder?: string;
+//   required?: boolean;
+//   options?: Array<{ label: string; value: any }>;
+// }

package/dist/esm/studio/types/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./block";
+export * from "./field";
+export * from "./field-values";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/studio/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/studio/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AAExB,cAAc,gBAAgB,CAAC"}

package/dist/esm/studio/types/index.js

@@ -0,0 +1,3 @@
+export * from "./block";
+export * from "./field";
+export * from "./field-values";

package/dist/esm/types/index.d.ts

@@ -11,4 +11,5 @@ export * from "./navigation";
 export * from "./page";
 export * from "./press";
 export * from "./website";
+export * from "../studio/types/index";
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAE1B,cAAc,uBAAuB,CAAC"}

package/dist/esm/types/index.js

@@ -11,3 +11,4 @@ export * from "./navigation";
 export * from "./page";
 export * from "./press";
 export * from "./website";
+export * from "../studio/types/index";

package/dist/types/client.d.ts

@@ -1,6 +1,7 @@
 import { AxiosInstance, AxiosRequestConfig } from "axios";
 import { BackstageUserConfig } from "./config";
 import { AlertService } from "./endpoints/alerts";
+import { BlocksService } from "./endpoints/blocks";
 import { EventService } from "./endpoints/events";
 import { LocationService } from "./endpoints/locations";
 import { MenuService } from "./endpoints/menus";
@@ -11,6 +12,7 @@ import { WebsiteService } from "./endpoints/website";
 export declare class BackstageClient {
     private instance;
     readonly alerts: AlertService;
+    readonly blocks: BlocksService;
     readonly events: EventService;
     readonly locations: LocationService;
     readonly menus: MenuService;

package/dist/types/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,aAAa,EAAE,kBAAkB,EAA6B,MAAM,OAAO,CAAC;AAC5F,OAAO,EAAmB,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAgB;IAGhC,SAAgB,MAAM,EAAE,YAAY,CAAC;IACrC,SAAgB,MAAM,EAAE,YAAY,CAAC;IACrC,SAAgB,SAAS,EAAE,eAAe,CAAC;IAC3C,SAAgB,KAAK,EAAE,WAAW,CAAC;IACnC,SAAgB,UAAU,EAAE,iBAAiB,CAAC;IAC9C,SAAgB,KAAK,EAAE,WAAW,CAAC;IACnC,SAAgB,KAAK,EAAE,YAAY,CAAC;IACpC,SAAgB,OAAO,EAAE,cAAc,CAAC;gBAE5B,MAAM,CAAC,EAAE,mBAAmB;IAoE3B,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKtE,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKvF,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKtF,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKxF,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAK/E,gBAAgB,IAAI,aAAa;CAGzC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,aAAa,EAAE,kBAAkB,EAA6B,MAAM,OAAO,CAAC;AAC5F,OAAO,EAAmB,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAgB;IAGhC,SAAgB,MAAM,EAAE,YAAY,CAAC;IACrC,SAAgB,MAAM,EAAE,aAAa,CAAC;IACtC,SAAgB,MAAM,EAAE,YAAY,CAAC;IACrC,SAAgB,SAAS,EAAE,eAAe,CAAC;IAC3C,SAAgB,KAAK,EAAE,WAAW,CAAC;IACnC,SAAgB,UAAU,EAAE,iBAAiB,CAAC;IAC9C,SAAgB,KAAK,EAAE,WAAW,CAAC;IACnC,SAAgB,KAAK,EAAE,YAAY,CAAC;IACpC,SAAgB,OAAO,EAAE,cAAc,CAAC;gBAE5B,MAAM,CAAC,EAAE,mBAAmB;IAqE3B,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKtE,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKvF,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKtF,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAKxF,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC;IAK/E,gBAAgB,IAAI,aAAa;CAGzC"}

package/dist/types/config.d.ts

@@ -1,8 +1,10 @@
 import { AxiosError } from "axios";
+import type { BlockDefinition } from "./studio/types";
 export interface BackstageUserConfig {
     accountId?: string | undefined;
     token?: string | undefined;
     baseURL?: string;
+    blocks?: BlockDefinition<any>[] | undefined;
     onError?: (error: AxiosError) => void;
 }
 export declare function defineConfig(config: BackstageUserConfig): BackstageUserConfig;

package/dist/types/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAMnC,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CACvC;AAQD,wBAAgB,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,mBAAmB,CAM7E;AAED,wBAAgB,eAAe,IAAI,mBAAmB,CAGrD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAMtD,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,GAAG,SAAS,CAAC;IAC5C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CACvC;AAQD,wBAAgB,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,mBAAmB,CAM7E;AAED,wBAAgB,eAAe,IAAI,mBAAmB,CAGrD"}

package/dist/types/endpoints/blocks.d.ts

@@ -0,0 +1,13 @@
+import { BaseService } from "./base";
+interface BlockParams {
+    name: string;
+    slug: string;
+    schema: any;
+}
+export declare class BlocksService extends BaseService {
+    all(): Promise<void>;
+    create({ name, slug, schema }: BlockParams): Promise<BlockParams>;
+    update(id: string, { name, slug, schema }: BlockParams): Promise<BlockParams>;
+}
+export {};
+//# sourceMappingURL=blocks.d.ts.map

package/dist/types/endpoints/blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../../src/endpoints/blocks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,GAAG,CAAC;CACb;AAED,qBAAa,aAAc,SAAQ,WAAW;IACtC,GAAG;IAEH,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW;IAK1C,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW;CAI7D"}

package/dist/types/studio/define-block.d.ts

@@ -0,0 +1,8 @@
+import { BlockSchema, BlockDefinition, BlockComponentProps } from "./types";
+export declare function defineBlock(options: {
+    name: string;
+    slug: string;
+    schema: BlockSchema<any>;
+    component: React.ComponentType<BlockComponentProps<typeof options.schema>>;
+}): BlockDefinition<typeof options.schema.fields>;
+//# sourceMappingURL=define-block.d.ts.map

package/dist/types/studio/define-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-block.d.ts","sourceRoot":"","sources":["../../../src/studio/define-block.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE5E,wBAAgB,WAAW,CAAC,OAAO,EAAE;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC;IACzB,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,mBAAmB,CAAC,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;CAC5E,GAAG,eAAe,CAAC,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAmBhD"}

package/dist/types/studio/define-field.d.ts

@@ -0,0 +1,3 @@
+import { Field } from "./types";
+export declare function defineField<T extends Field>(field: T): T;
+//# sourceMappingURL=define-field.d.ts.map

package/dist/types/studio/define-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-field.d.ts","sourceRoot":"","sources":["../../../src/studio/define-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,wBAAgB,WAAW,CAAC,CAAC,SAAS,KAAK,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAExD"}

package/dist/types/studio/define-schema.d.ts

@@ -0,0 +1,4 @@
+import { BlockSchema, Field } from "./types";
+export type SchemaFields = Record<string, Field>;
+export declare function defineSchema<T extends SchemaFields>(schema: BlockSchema<T>): BlockSchema<T>;
+//# sourceMappingURL=define-schema.d.ts.map

package/dist/types/studio/define-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-schema.d.ts","sourceRoot":"","sources":["../../../src/studio/define-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAEjD,wBAAgB,YAAY,CAAC,CAAC,SAAS,YAAY,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,kBAE1E"}

package/dist/types/studio/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./types";
+export * from "./define-block";
+export * from "./define-field";
+export * from "./define-schema";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/studio/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/studio/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AAExB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC"}

package/dist/types/studio/types/block.d.ts

@@ -0,0 +1,31 @@
+import { Field, FieldType, FieldTypeToValue } from "./field";
+type FieldValues<T extends Record<string, Field>> = {
+    [K in keyof T]: T[K] extends {
+        type: infer Type;
+    } ? (Type extends FieldType ? FieldTypeToValue[Type] : never) : never;
+};
+export interface BlockSchema<TFields extends Record<string, Field>> {
+    fields: TFields;
+    properties?: BlockProperties;
+}
+export interface BlockDefinition<TFields extends Record<string, Field>> {
+    name: string;
+    slug: string;
+    schema: BlockSchema<TFields>;
+    component: React.ComponentType<BlockComponentProps<any>>;
+}
+export interface BlockProperties {
+    customClassName?: string;
+}
+export interface BuilderBlock<TSchema extends BlockSchema<Record<string, Field>>> {
+    id: string;
+    type: string;
+    fields: FieldValues<TSchema["fields"]>;
+    properties?: BlockProperties;
+}
+export interface BlockComponentProps<TSchema extends BlockSchema<Record<string, Field>>> {
+    block: BuilderBlock<TSchema>;
+    onFieldChange: (blockId: string, fieldName: keyof TSchema["fields"], value: any) => void;
+}
+export {};
+//# sourceMappingURL=block.d.ts.map

package/dist/types/studio/types/block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block.d.ts","sourceRoot":"","sources":["../../../../src/studio/types/block.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE7D,KAAK,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI;KACjD,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;QAAE,IAAI,EAAE,MAAM,IAAI,CAAA;KAAE,GAAG,CAAC,IAAI,SAAS,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK;CACtH,CAAC;AAEF,MAAM,WAAW,WAAW,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAChE,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC7B,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,eAAe;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY,CAAC,OAAO,SAAS,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9E,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvC,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB,CAAC,OAAO,SAAS,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACrF,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;IAC7B,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;CAC1F"}

package/dist/types/studio/types/field-values.d.ts

@@ -0,0 +1,8 @@
+export interface Media {
+    id: string;
+    url: string;
+    width: number;
+    height: number;
+    alt: string;
+}
+//# sourceMappingURL=field-values.d.ts.map

package/dist/types/studio/types/field-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-values.d.ts","sourceRoot":"","sources":["../../../../src/studio/types/field-values.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb"}

package/dist/types/studio/types/field.d.ts

@@ -0,0 +1,40 @@
+import { MediaItem } from "../../types";
+type Nullable<T> = T | null;
+export type FieldTypeToValue = {
+    boolean: Nullable<boolean>;
+    event_select: Nullable<string>;
+    form_select: Nullable<string>;
+    image: Nullable<MediaItem>;
+    image_list: Nullable<MediaItem[]>;
+    list_array: Nullable<string[]>;
+    media: Nullable<MediaItem>;
+    menu_select: Nullable<string>;
+    number: Nullable<number>;
+    press_select: Nullable<string>;
+    repeater: Nullable<any[]>;
+    rich_text: Nullable<string>;
+    separator: never;
+    spacer: never;
+    text: Nullable<string>;
+    textarea: Nullable<string>;
+    url: Nullable<string>;
+};
+export type FieldType = keyof FieldTypeToValue;
+export type BaseField = {
+    name: string;
+    slug: string;
+    placeholder?: string;
+    required?: boolean;
+    options?: Array<{
+        label: string;
+        value: any;
+    }>;
+};
+export type Field = {
+    [K in FieldType]: BaseField & {
+        type: K;
+        value?: FieldTypeToValue[K];
+    };
+}[FieldType];
+export {};
+//# sourceMappingURL=field.d.ts.map

package/dist/types/studio/types/field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../../../src/studio/types/field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE5B,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3B,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/B,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9B,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC3B,UAAU,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;IAClC,UAAU,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/B,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC3B,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzB,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;IAC1B,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC5B,SAAS,EAAE,KAAK,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACvB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3B,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CACvB,CAAC;AACF,MAAM,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC;AAE/C,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;KACjB,CAAC,IAAI,SAAS,GAAG,SAAS,GAAG;QAC5B,IAAI,EAAE,CAAC,CAAC;QACR,KAAK,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;KAC7B;CACF,CAAC,SAAS,CAAC,CAAC"}

package/dist/types/studio/types/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./block";
+export * from "./field";
+export * from "./field-values";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/studio/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/studio/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AAExB,cAAc,gBAAgB,CAAC"}

package/dist/types/types/index.d.ts

@@ -11,4 +11,5 @@ export * from "./navigation";
 export * from "./page";
 export * from "./press";
 export * from "./website";
+export * from "../studio/types/index";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAE1B,cAAc,uBAAuB,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@antlur/backstage",
   "author": "Anthony Holmes",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "description": "A simple client for Backstage CMS",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
@@ -17,6 +17,11 @@
       "import": "./dist/esm/types/index.js",
       "types": "./dist/types/types/*.d.ts"
     },
+    "./studio": {
+      "require": "./dist/cjs/studio/index.js",
+      "import": "./dist/esm/studio/index.js",
+      "types": "./dist/types/studio/*.d.ts"
+    },
     "./*": {
       "require": "./dist/cjs/*.js",
       "import": "./dist/esm/*.js",

package/src/client.ts

@@ -1,6 +1,7 @@
 import axios, { AxiosInstance, AxiosRequestConfig, AxiosResponse, AxiosError } from "axios";
 import { getGlobalConfig, BackstageUserConfig } from "./config";
 import { AlertService } from "./endpoints/alerts";
+import { BlocksService } from "./endpoints/blocks";
 import { EventService } from "./endpoints/events";
 import { LocationService } from "./endpoints/locations";
 import { MenuService } from "./endpoints/menus";
@@ -14,6 +15,7 @@ export class BackstageClient {
 
   // Service Instances
   public readonly alerts: AlertService;
+  public readonly blocks: BlocksService;
   public readonly events: EventService;
   public readonly locations: LocationService;
   public readonly menus: MenuService;
@@ -81,6 +83,7 @@ export class BackstageClient {
 
     // Initialize service instances
     this.alerts = new AlertService(this);
+    this.blocks = new BlocksService(this);
     this.events = new EventService(this);
     this.locations = new LocationService(this);
     this.menus = new MenuService(this);

package/src/config.ts

@@ -1,4 +1,5 @@
 import { AxiosError } from "axios";
+import type { BlockDefinition } from "./studio/types";
 
 const ROOT = process.cwd();
 const CONFIG_PATH = process.env.BACKSTAGE_CONFIG_PATH || "./backstage.config";
@@ -8,6 +9,7 @@ export interface BackstageUserConfig {
   accountId?: string | undefined;
   token?: string | undefined;
   baseURL?: string;
+  blocks?: BlockDefinition<any>[] | undefined;
   onError?: (error: AxiosError) => void;
 }
 

package/src/endpoints/blocks.ts

@@ -0,0 +1,22 @@
+import { ApiSingleResponse } from "../types";
+import { BaseService } from "./base";
+
+interface BlockParams {
+  name: string;
+  slug: string;
+  schema: any;
+}
+
+export class BlocksService extends BaseService {
+  async all() {}
+
+  async create({ name, slug, schema }: BlockParams) {
+    const res = await this.client.post<ApiSingleResponse<BlockParams>>("/blocks", { name, slug, schema });
+    return res.data;
+  }
+
+  async update(id: string, { name, slug, schema }: BlockParams) {
+    const res = await this.client.put<ApiSingleResponse<BlockParams>>(`/blocks/${id}`, { name, slug, schema });
+    return res.data;
+  }
+}

package/src/studio/define-block.ts

@@ -0,0 +1,27 @@
+import { BlockSchema, BlockDefinition, BlockComponentProps } from "./types";
+
+export function defineBlock(options: {
+  name: string;
+  slug: string;
+  schema: BlockSchema<any>;
+  component: React.ComponentType<BlockComponentProps<typeof options.schema>>;
+}): BlockDefinition<typeof options.schema.fields> {
+  // Runtime validation
+  if (!options.name || typeof options.name !== "string") {
+    throw new Error("Block name is required and must be a string");
+  }
+
+  if (!options.slug || typeof options.slug !== "string") {
+    throw new Error("Block slug is required and must be a string");
+  }
+
+  if (!options.schema || typeof options.schema !== "object") {
+    throw new Error("Block schema is required and must be an object");
+  }
+
+  if (!options.component) {
+    throw new Error("Block component is required");
+  }
+
+  return options;
+}

package/src/studio/define-field.ts

@@ -0,0 +1,5 @@
+import { Field } from "./types";
+
+export function defineField<T extends Field>(field: T): T {
+  return field;
+}

package/src/studio/define-schema.ts

@@ -0,0 +1,7 @@
+import { BlockSchema, Field } from "./types";
+
+export type SchemaFields = Record<string, Field>;
+
+export function defineSchema<T extends SchemaFields>(schema: BlockSchema<T>) {
+  return schema;
+}

package/src/studio/index.ts

@@ -0,0 +1,5 @@
+export * from "./types";
+
+export * from "./define-block";
+export * from "./define-field";
+export * from "./define-schema";

package/src/studio/types/block.ts

@@ -0,0 +1,33 @@
+import { Field, FieldType, FieldTypeToValue } from "./field";
+
+type FieldValues<T extends Record<string, Field>> = {
+  [K in keyof T]: T[K] extends { type: infer Type } ? (Type extends FieldType ? FieldTypeToValue[Type] : never) : never;
+};
+
+export interface BlockSchema<TFields extends Record<string, Field>> {
+  fields: TFields;
+  properties?: BlockProperties;
+}
+
+export interface BlockDefinition<TFields extends Record<string, Field>> {
+  name: string;
+  slug: string;
+  schema: BlockSchema<TFields>;
+  component: React.ComponentType<BlockComponentProps<any>>;
+}
+
+export interface BlockProperties {
+  customClassName?: string;
+}
+
+export interface BuilderBlock<TSchema extends BlockSchema<Record<string, Field>>> {
+  id: string;
+  type: string;
+  fields: FieldValues<TSchema["fields"]>;
+  properties?: BlockProperties;
+}
+
+export interface BlockComponentProps<TSchema extends BlockSchema<Record<string, Field>>> {
+  block: BuilderBlock<TSchema>;
+  onFieldChange: (blockId: string, fieldName: keyof TSchema["fields"], value: any) => void;
+}

package/src/studio/types/field-values.ts

@@ -0,0 +1,7 @@
+export interface Media {
+  id: string;
+  url: string;
+  width: number;
+  height: number;
+  alt: string;
+}

package/src/studio/types/field.ts

@@ -0,0 +1,49 @@
+import { MediaItem } from "../../types";
+
+type Nullable<T> = T | null;
+
+export type FieldTypeToValue = {
+  boolean: Nullable<boolean>;
+  event_select: Nullable<string>;
+  form_select: Nullable<string>;
+  image: Nullable<MediaItem>;
+  image_list: Nullable<MediaItem[]>;
+  list_array: Nullable<string[]>;
+  media: Nullable<MediaItem>;
+  menu_select: Nullable<string>;
+  number: Nullable<number>;
+  press_select: Nullable<string>;
+  repeater: Nullable<any[]>;
+  rich_text: Nullable<string>;
+  separator: never;
+  spacer: never;
+  text: Nullable<string>;
+  textarea: Nullable<string>;
+  url: Nullable<string>;
+};
+export type FieldType = keyof FieldTypeToValue;
+
+export type BaseField = {
+  name: string;
+  slug: string;
+  placeholder?: string;
+  required?: boolean;
+  options?: Array<{ label: string; value: any }>;
+};
+
+export type Field = {
+  [K in FieldType]: BaseField & {
+    type: K;
+    value?: FieldTypeToValue[K];
+  };
+}[FieldType];
+
+// export interface Field<T extends FieldType = FieldType> {
+//   name: string;
+//   slug: string;
+//   type: FieldType;
+//   value?: FieldTypeToValue[T];
+//   placeholder?: string;
+//   required?: boolean;
+//   options?: Array<{ label: string; value: any }>;
+// }

package/src/studio/types/index.ts

@@ -0,0 +1,4 @@
+export * from "./block";
+export * from "./field";
+
+export * from "./field-values";

package/src/types/index.ts

@@ -11,3 +11,5 @@ export * from "./navigation";
 export * from "./page";
 export * from "./press";
 export * from "./website";
+
+export * from "../studio/types/index";