@antlur/backstage 1.12.12 → 1.12.14

package/dist/cli/actions/sync-blueprints.d.ts

@@ -0,0 +1,3 @@
+import type { BackstageUserConfig } from "../../config.js";
+export declare function syncBlueprints(config: BackstageUserConfig): Promise<void>;
+//# sourceMappingURL=sync-blueprints.d.ts.map

package/dist/cli/actions/sync-blueprints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-blueprints.d.ts","sourceRoot":"","sources":["../../../src/cli/actions/sync-blueprints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAG3D,wBAAsB,cAAc,CAAC,MAAM,EAAE,mBAAmB,iBAyC/D"}

package/dist/cli/actions/sync-blueprints.js

@@ -0,0 +1,42 @@
+import { BackstageClient } from "../../client.js";
+export async function syncBlueprints(config) {
+    const client = new BackstageClient(config);
+    if (!config.blueprints || !config.blueprints.length) {
+        console.log("No blueprints found in config");
+        return;
+    }
+    const syncPromises = config.blueprints.map(async (blueprint) => {
+        const blueprintData = {
+            name: blueprint.name,
+            slug: blueprint.slug,
+            slug_single: blueprint.slug_single,
+            description: blueprint.description,
+            is_routable: blueprint.is_routable,
+            has_location: blueprint.has_location,
+            has_route_index: blueprint.has_route_index,
+            fields: blueprint.fields,
+        };
+        try {
+            await client.blueprints.create(blueprintData);
+            console.log(`✓ Blueprint ${blueprint.slug} created`);
+        }
+        catch (err) {
+            if (err?.response?.status === 409) {
+                const id = err.response.data;
+                console.log(`⚠ Blueprint ${blueprint.slug} already exists with id ${id}. Updating...`);
+                try {
+                    await client.blueprints.update(id, blueprintData);
+                    console.log(`✓ Blueprint ${blueprint.slug} updated`);
+                }
+                catch (updateErr) {
+                    console.error(`✗ Failed to update blueprint ${blueprint.slug}:`, updateErr?.message || updateErr);
+                }
+            }
+            else {
+                console.error(`✗ Failed to create blueprint ${blueprint.slug}:`, err?.message || err);
+            }
+        }
+    });
+    await Promise.all(syncPromises);
+    console.log(`\nSync complete: ${config.blueprints.length} blueprint(s) processed`);
+}

package/dist/cli/cli.js

@@ -4,6 +4,7 @@ import { resolve } from "path";
 import { program } from "commander";
 import { loadBackstageConfig } from "./load-config.js";
 import { syncBlocks } from "./actions/sync-blocks.js";
+import { syncBlueprints } from "./actions/sync-blueprints.js";
 import { syncLayouts } from "./actions/sync-layouts.js";
 config({ path: resolve(process.cwd(), ".env") });
 program
@@ -12,7 +13,7 @@ program
     .version(process.env.npm_package_version || "1.0.0");
 program
     .command("sync <type>")
-    .description("Sync blocks and layouts with the Backstage CMS")
+    .description("Sync blocks, blueprints, and layouts with the Backstage CMS")
     .action(async (type) => {
     const backstageConfig = await loadBackstageConfig();
     if (!backstageConfig) {
@@ -23,16 +24,21 @@ program
         await syncBlocks(backstageConfig);
         return;
     }
+    if (type === "blueprints") {
+        await syncBlueprints(backstageConfig);
+        return;
+    }
     if (type === "layouts") {
         await syncLayouts(backstageConfig);
         return;
     }
     if (type === "all") {
         await syncBlocks(backstageConfig);
+        await syncBlueprints(backstageConfig);
         await syncLayouts(backstageConfig);
         return;
     }
-    console.error(`Unknown type: ${type}. Valid types are: blocks, layouts, all`);
+    console.error(`Unknown type: ${type}. Valid types are: blocks, blueprints, layouts, all`);
     process.exit(1);
 });
 program.parse();

package/dist/client.d.ts

@@ -2,6 +2,7 @@ import { BackstageUserConfig } from "./config.js";
 import { AlertService } from "./endpoints/alerts.js";
 import { AuthService } from "./endpoints/auth.js";
 import { BlocksService } from "./endpoints/blocks.js";
+import { BlueprintsService } from "./endpoints/blueprints.js";
 import { EntryService } from "./endpoints/entries.js";
 import { EventService } from "./endpoints/events.js";
 import { FormService } from "./endpoints/forms.js";
@@ -24,6 +25,7 @@ export declare class BackstageClient {
     readonly alerts: AlertService;
     readonly auth: AuthService;
     readonly blocks: BlocksService;
+    readonly blueprints: BlueprintsService;
     readonly entries: EntryService;
     readonly events: EventService;
     readonly forms: FormService;

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.js

@@ -2,6 +2,7 @@ import { getGlobalConfig } from "./config.js";
 import { AlertService } from "./endpoints/alerts.js";
 import { AuthService } from "./endpoints/auth.js";
 import { BlocksService } from "./endpoints/blocks.js";
+import { BlueprintsService } from "./endpoints/blueprints.js";
 import { EntryService } from "./endpoints/entries.js";
 import { EventService } from "./endpoints/events.js";
 import { FormService } from "./endpoints/forms.js";
@@ -25,6 +26,7 @@ export class BackstageClient {
     alerts;
     auth;
     blocks;
+    blueprints;
     entries;
     events;
     forms;
@@ -61,6 +63,7 @@ export class BackstageClient {
         this.alerts = new AlertService(this);
         this.auth = new AuthService(this);
         this.blocks = new BlocksService(this);
+        this.blueprints = new BlueprintsService(this);
         this.entries = new EntryService(this);
         this.events = new EventService(this);
         this.forms = new FormService(this);

package/dist/config.d.ts

@@ -1,9 +1,35 @@
 import type { BlockDefinition } from "./studio/types/index.js";
+export interface BlueprintDefinition {
+    name: string;
+    slug: string;
+    slug_single?: string;
+    description?: string;
+    is_routable?: boolean;
+    has_location?: boolean;
+    has_route_index?: boolean;
+    fields: Array<{
+        name: string;
+        slug: string;
+        type: string;
+        type_id?: string | null;
+        is_primary?: boolean;
+        is_multiple?: boolean;
+        show_in_list?: boolean;
+        order: number;
+        allowed_references?: string[];
+        options?: Array<{
+            label: string;
+            value: any;
+        }>;
+        placeholder?: string;
+    }>;
+}
 export interface BackstageUserConfig {
     accountId?: string | undefined;
     token?: string | undefined;
     baseURL?: string;
     blocks?: BlockDefinition<any>[] | undefined;
+    blueprints?: BlueprintDefinition[] | undefined;
     layouts?: any[] | undefined;
     onError?: (error: Error) => void;
 }

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAI/D,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,GAAG,EAAE,GAAG,SAAS,CAAC;IAC5B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;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,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAI/D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC9B,OAAO,CAAC,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,GAAG,CAAA;SAAE,CAAC,CAAC;QAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ;AAED,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,UAAU,CAAC,EAAE,mBAAmB,EAAE,GAAG,SAAS,CAAC;IAC/C,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,SAAS,CAAC;IAC5B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAQD,wBAAgB,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,mBAAmB,CAM7E;AAED,wBAAgB,eAAe,IAAI,mBAAmB,CAGrD"}

package/dist/endpoints/blueprints.d.ts

@@ -0,0 +1,37 @@
+import type { Blueprint } from "../types/blueprint";
+import { BaseService } from "./base.js";
+export interface CreateBlueprintParams {
+    name: string;
+    slug: string;
+    slug_single?: string;
+    description?: string;
+    is_routable?: boolean;
+    has_location?: boolean;
+    has_route_index?: boolean;
+    fields: Array<{
+        name: string;
+        slug: string;
+        type: string;
+        type_id?: string | null;
+        is_primary?: boolean;
+        is_multiple?: boolean;
+        show_in_list?: boolean;
+        order: number;
+        allowed_references?: string[];
+        options?: Array<{
+            label: string;
+            value: any;
+        }>;
+        placeholder?: string;
+    }>;
+}
+export interface UpdateBlueprintParams extends Partial<CreateBlueprintParams> {
+}
+export declare class BlueprintsService extends BaseService {
+    list(options?: RequestInit): Promise<Blueprint[]>;
+    get(id: string, options?: RequestInit): Promise<Blueprint | null>;
+    create(params: CreateBlueprintParams, options?: RequestInit): Promise<Blueprint>;
+    update(id: string, params: UpdateBlueprintParams, options?: RequestInit): Promise<Blueprint>;
+    delete(id: string, options?: RequestInit): Promise<void>;
+}
+//# sourceMappingURL=blueprints.d.ts.map

package/dist/endpoints/blueprints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprints.d.ts","sourceRoot":"","sources":["../../src/endpoints/blueprints.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC9B,OAAO,CAAC,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,GAAG,CAAA;SAAE,CAAC,CAAC;QAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,qBAAsB,SAAQ,OAAO,CAAC,qBAAqB,CAAC;CAAG;AAEhF,qBAAa,iBAAkB,SAAQ,WAAW;IAC1C,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAKjD,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IASjE,MAAM,CAAC,MAAM,EAAE,qBAAqB,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC;IAKhF,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC;IAK5F,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAG/D"}

package/dist/endpoints/blueprints.js

@@ -0,0 +1,27 @@
+import { BaseService } from "./base.js";
+export class BlueprintsService extends BaseService {
+    async list(options) {
+        const { data } = await this.client.get("/blueprints", options);
+        return data;
+    }
+    async get(id, options) {
+        try {
+            const { data } = await this.client.get(`/blueprints/${id}`, options);
+            return data;
+        }
+        catch (error) {
+            return null;
+        }
+    }
+    async create(params, options) {
+        const { data } = await this.client.post("/blueprints", params, options);
+        return data;
+    }
+    async update(id, params, options) {
+        const { data } = await this.client.put(`/blueprints/${id}`, params, options);
+        return data;
+    }
+    async delete(id, options) {
+        await this.client.delete(`/blueprints/${id}`, options);
+    }
+}

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export { BackstageClient } from "./client.js";
 export * from "./endpoints/alerts.js";
 export * from "./endpoints/auth.js";
 export * from "./endpoints/blocks.js";
+export * from "./endpoints/blueprints.js";
 export * from "./endpoints/entries.js";
 export * from "./endpoints/events.js";
 export * from "./endpoints/forms.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG5D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG5D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -6,6 +6,7 @@ export { BackstageClient } from "./client.js";
 export * from "./endpoints/alerts.js";
 export * from "./endpoints/auth.js";
 export * from "./endpoints/blocks.js";
+export * from "./endpoints/blueprints.js";
 export * from "./endpoints/entries.js";
 export * from "./endpoints/events.js";
 export * from "./endpoints/forms.js";

package/dist/studio/define-blueprint.d.ts

@@ -0,0 +1,3 @@
+import type { BlueprintDefinition } from "../config.js";
+export declare function defineBlueprint(blueprint: BlueprintDefinition): BlueprintDefinition;
+//# sourceMappingURL=define-blueprint.d.ts.map

package/dist/studio/define-blueprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-blueprint.d.ts","sourceRoot":"","sources":["../../src/studio/define-blueprint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,wBAAgB,eAAe,CAAC,SAAS,EAAE,mBAAmB,GAAG,mBAAmB,CAEnF"}

package/dist/studio/define-blueprint.js

@@ -0,0 +1,3 @@
+export function defineBlueprint(blueprint) {
+    return blueprint;
+}

package/dist/studio/index.d.ts

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

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

@@ -1 +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;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC"}
+{"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,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC"}

package/dist/studio/index.js

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

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

@@ -1,10 +1,17 @@
 import { Field, FieldType, FieldTypeToValue } from "./field";
+import { Entry } from "../../types/entry";
+type Nullable<T> = T | null;
 type FieldValues<T extends readonly Field[]> = {
     [K in T[number]["slug"]]: Extract<T[number], {
         slug: K;
-    }> extends {
+    }> extends infer FieldDef ? FieldDef extends {
+        type: 'reference';
+        is_multiple: true;
+    } ? Nullable<Entry[]> : FieldDef extends {
+        type: 'reference';
+    } ? Nullable<Entry> : FieldDef extends {
         type: infer Type;
-    } ? Type extends FieldType ? FieldTypeToValue[Type] : never : never;
+    } ? Type extends FieldType ? FieldTypeToValue[Type] : never : never : never;
 };
 export interface BlockSchema<TFields extends readonly Field[]> {
     fields: TFields;

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

@@ -1 +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;AAG7D,KAAK,WAAW,CAAC,CAAC,SAAS,SAAS,KAAK,EAAE,IAAI;KAC5C,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,SAAS;QAAE,IAAI,EAAE,MAAM,IAAI,CAAA;KAAE,GAClF,IAAI,SAAS,SAAS,GACpB,gBAAgB,CAAC,IAAI,CAAC,GACtB,KAAK,GACP,KAAK;CACV,CAAC;AAEF,MAAM,WAAW,WAAW,CAAC,OAAO,SAAS,SAAS,KAAK,EAAE;IAC3D,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe,CAAC,OAAO,SAAS,SAAS,KAAK,EAAE;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC7B,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,eAAe;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY,CAAC,OAAO,SAAS,WAAW,CAAC,SAAS,KAAK,EAAE,CAAC;IACzE,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,SAAS,KAAK,EAAE,CAAC;IAChF,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;IAC7B,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;CACpG;AAED,MAAM,MAAM,cAAc,CAAC,OAAO,SAAS,WAAW,CAAC,SAAS,KAAK,EAAE,CAAC,IAAI,KAAK,CAAC,aAAa,CAC7F,mBAAmB,CAAC,OAAO,CAAC,CAC7B,CAAC"}
+{"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;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAG5B,KAAK,WAAW,CAAC,CAAC,SAAS,SAAS,KAAK,EAAE,IAAI;KAC5C,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,SAAS,MAAM,QAAQ,GAC5E,QAAQ,SAAS;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,WAAW,EAAE,IAAI,CAAA;KAAE,GACvD,QAAQ,CAAC,KAAK,EAAE,CAAC,GACjB,QAAQ,SAAS;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,GACpC,QAAQ,CAAC,KAAK,CAAC,GACf,QAAQ,SAAS;QAAE,IAAI,EAAE,MAAM,IAAI,CAAA;KAAE,GACnC,IAAI,SAAS,SAAS,GACpB,gBAAgB,CAAC,IAAI,CAAC,GACtB,KAAK,GACP,KAAK,GACX,KAAK;CACV,CAAC;AAEF,MAAM,WAAW,WAAW,CAAC,OAAO,SAAS,SAAS,KAAK,EAAE;IAC3D,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe,CAAC,OAAO,SAAS,SAAS,KAAK,EAAE;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC7B,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,eAAe;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY,CAAC,OAAO,SAAS,WAAW,CAAC,SAAS,KAAK,EAAE,CAAC;IACzE,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,SAAS,KAAK,EAAE,CAAC;IAChF,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;IAC7B,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;CACpG;AAED,MAAM,MAAM,cAAc,CAAC,OAAO,SAAS,WAAW,CAAC,SAAS,KAAK,EAAE,CAAC,IAAI,KAAK,CAAC,aAAa,CAC7F,mBAAmB,CAAC,OAAO,CAAC,CAC7B,CAAC"}

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

@@ -1,22 +1,34 @@
 import { MediaItem } from "../../types";
+import { Entry } from "../../types/entry";
 type Nullable<T> = T | null;
 export type FieldTypeToValue = {
     boolean: Nullable<boolean>;
+    date: Nullable<string>;
+    datetime: Nullable<string>;
+    email: Nullable<string>;
     event_select: Nullable<string>;
+    fieldset: never;
     form_select: Nullable<string>;
     image: Nullable<MediaItem>;
     image_list: Nullable<MediaItem[]>;
+    json: Nullable<any>;
     list_array: Nullable<string[]>;
+    location: Nullable<string>;
+    markdown: Nullable<string>;
     media: Nullable<MediaItem>;
     menu_select: Nullable<string>;
     number: Nullable<number>;
     press_select: Nullable<string>;
+    reference: Nullable<Entry | Entry[]>;
     repeater: Nullable<any[]>;
     rich_text: Nullable<string>;
+    select: Nullable<string>;
     separator: never;
+    slug: Nullable<string>;
     spacer: never;
     text: Nullable<string>;
     textarea: Nullable<string>;
+    time: Nullable<string>;
     url: Nullable<string>;
     navigation_select: Nullable<string>;
     page_select: Nullable<string>;
@@ -32,10 +44,20 @@ export type BaseField = {
         label: string;
         value: any;
     }>;
+    allowed_references?: string[];
+    is_multiple?: boolean;
+    is_primary?: boolean;
+    show_in_list?: boolean;
+    order?: number;
+    type_id?: string | null;
     fields?: Field[];
 };
 export type Field = {
-    [K in FieldType]: BaseField & {
+    [K in FieldType]: K extends 'reference' ? BaseField & {
+        type: K;
+        value?: FieldTypeToValue[K];
+        is_multiple?: boolean;
+    } : BaseField & {
         type: K;
         value?: FieldTypeToValue[K];
     };

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

@@ -1 +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;IACtB,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CAC/B,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,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;IAC/C,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;CAClB,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"}
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../../src/studio/types/field.ts"],"names":[],"mappings":"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"}

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

@@ -1,10 +1,17 @@
 import { Field, FieldType, FieldTypeToValue } from "./field";
+import { Entry } from "../../types/entry";
+type Nullable<T> = T | null;
 type FieldValues<T extends readonly Field[]> = {
     [K in T[number]["slug"]]: Extract<T[number], {
         slug: K;
-    }> extends {
+    }> extends infer FieldDef ? FieldDef extends {
+        type: 'reference';
+        is_multiple: true;
+    } ? Nullable<Entry[]> : FieldDef extends {
+        type: 'reference';
+    } ? Nullable<Entry> : FieldDef extends {
         type: infer Type;
-    } ? Type extends FieldType ? FieldTypeToValue[Type] : never : never;
+    } ? Type extends FieldType ? FieldTypeToValue[Type] : never : never : never;
 };
 export interface LayoutSchema<TFields extends readonly Field[]> {
     fields: TFields;

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

@@ -1 +1 @@
-{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/studio/types/layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAG7D,KAAK,WAAW,CAAC,CAAC,SAAS,SAAS,KAAK,EAAE,IAAI;KAC5C,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,SAAS;QAAE,IAAI,EAAE,MAAM,IAAI,CAAA;KAAE,GAClF,IAAI,SAAS,SAAS,GACpB,gBAAgB,CAAC,IAAI,CAAC,GACtB,KAAK,GACP,KAAK;CACV,CAAC;AAEF,MAAM,WAAW,YAAY,CAAC,OAAO,SAAS,SAAS,KAAK,EAAE;IAC5D,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB,CAAC,OAAO,SAAS,SAAS,KAAK,EAAE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,oBAAoB,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;CAC7E;AAED,MAAM,WAAW,oBAAoB,CAAC,OAAO,SAAS,YAAY,CAAC,SAAS,KAAK,EAAE,CAAC;IAClF,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;CACrG"}
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/studio/types/layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAG5B,KAAK,WAAW,CAAC,CAAC,SAAS,SAAS,KAAK,EAAE,IAAI;KAC5C,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,SAAS,MAAM,QAAQ,GAC5E,QAAQ,SAAS;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,WAAW,EAAE,IAAI,CAAA;KAAE,GACvD,QAAQ,CAAC,KAAK,EAAE,CAAC,GACjB,QAAQ,SAAS;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,GACpC,QAAQ,CAAC,KAAK,CAAC,GACf,QAAQ,SAAS;QAAE,IAAI,EAAE,MAAM,IAAI,CAAA;KAAE,GACnC,IAAI,SAAS,SAAS,GACpB,gBAAgB,CAAC,IAAI,CAAC,GACtB,KAAK,GACP,KAAK,GACX,KAAK;CACV,CAAC;AAEF,MAAM,WAAW,YAAY,CAAC,OAAO,SAAS,SAAS,KAAK,EAAE;IAC5D,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB,CAAC,OAAO,SAAS,SAAS,KAAK,EAAE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,oBAAoB,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;CAC7E;AAED,MAAM,WAAW,oBAAoB,CAAC,OAAO,SAAS,YAAY,CAAC,SAAS,KAAK,EAAE,CAAC;IAClF,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;CACrG"}

package/dist/types/blueprint.d.ts

@@ -1,10 +1,34 @@
+export interface BlueprintField {
+    id: string;
+    blueprint_id: string;
+    name: string;
+    slug: string;
+    type: string;
+    type_id: string | null;
+    is_primary: boolean;
+    is_multiple: boolean;
+    show_in_list: boolean;
+    order: number;
+    allowed_references: string[] | null;
+    options: Array<{
+        label: string;
+        value: any;
+    }> | null;
+    placeholder: string | null;
+    created_at: string;
+    updated_at: string;
+}
 export interface Blueprint {
     id: string;
     account_id: string;
     name: string;
     slug: string;
+    slug_single: string;
     description: string | null;
-    schema: any;
+    is_routable: boolean;
+    has_location: boolean;
+    has_route_index: boolean;
+    fields: BlueprintField[];
     created_at: string;
     updated_at: string;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"blueprint.d.ts","sourceRoot":"","sources":["../../src/types/blueprint.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,GAAG,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB"}
+{"version":3,"file":"blueprint.d.ts","sourceRoot":"","sources":["../../src/types/blueprint.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACpC,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,GAAG,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;IACrD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@antlur/backstage",
   "author": "Anthony Holmes",
-  "version": "1.12.12",
+  "version": "1.12.14",
   "description": "A simple client for Backstage CMS",
   "license": "MIT",
   "repository": {

package/readme.md

@@ -7,7 +7,8 @@ A TypeScript client library for [Backstage CMS](https://bckstg.app) with type-sa
 - 🔐 Type-safe API client for Backstage CMS
 - 🧱 Define custom blocks with full TypeScript support
 - 📐 Define custom layouts with schema validation
-- 🔄 CLI tools for syncing blocks and layouts
+- � Define custom blueprints (content types) with field schemas
+- 🔄 CLI tools for syncing blocks, blueprints, and layouts
 - ⚛️ React components for page metadata and structured data
 - 🎨 Framework-agnostic design (works with Next.js, React, etc.)
 
@@ -90,11 +91,13 @@ const heroFields = [
     slug: "title",
     type: "text",
     required: true,
+    placeholder: "Enter hero title...",
   }),
   defineField({
     name: "Subtitle",
     slug: "subtitle",
-    type: "text",
+    type: "textarea",
+    description: "Optional subtitle text",
   }),
   defineField({
     name: "Background Image",
@@ -102,6 +105,25 @@ const heroFields = [
     type: "image",
     required: true,
   }),
+  defineField({
+    name: "Display Style",
+    slug: "displayStyle",
+    type: "select",
+    options: [
+      { label: "Full Width", value: "full" },
+      { label: "Centered", value: "centered" },
+      { label: "Left Aligned", value: "left" },
+    ],
+    required: true,
+  }),
+  defineField({
+    name: "Featured Products",
+    slug: "featuredProducts",
+    type: "reference",
+    allowed_references: ["products"],
+    is_multiple: true,
+    description: "Select products to feature",
+  }),
 ] as const;
 
 export const schema = defineBlockSchema({
@@ -143,14 +165,175 @@ export const heroBlock = defineBlock({
 });
 ```
 
+## Defining Custom Blueprints
+
+Create content types (blueprints) with custom field schemas:
+
+```typescript
+// blueprints/customer.ts
+import { defineBlueprint } from "@antlur/backstage/studio";
+
+export const customerBlueprint = defineBlueprint({
+  name: "Customer",
+  slug: "customers",
+  description: "Customer testimonials and information",
+  fields: [
+    {
+      name: "Name",
+      slug: "name",
+      type: "text",
+      is_primary: true, // Primary field for display
+      required: true,
+      placeholder: "Customer full name",
+    },
+    {
+      name: "Email",
+      slug: "email",
+      type: "email",
+      required: true,
+      placeholder: "customer@example.com",
+    },
+    {
+      name: "Company",
+      slug: "company",
+      type: "text",
+      placeholder: "Company name",
+    },
+    {
+      name: "Photo",
+      slug: "photo",
+      type: "image",
+    },
+    {
+      name: "Testimonial",
+      slug: "testimonial",
+      type: "textarea",
+      required: true,
+      placeholder: "Customer testimonial...",
+    },
+    {
+      name: "Rating",
+      slug: "rating",
+      type: "select",
+      options: [
+        { label: "5 Stars", value: 5 },
+        { label: "4 Stars", value: 4 },
+        { label: "3 Stars", value: 3 },
+        { label: "2 Stars", value: 2 },
+        { label: "1 Star", value: 1 },
+      ],
+      required: true,
+    },
+    {
+      name: "Show in Testimonials",
+      slug: "showInTestimonials",
+      type: "boolean",
+      show_in_list: true, // Show in admin list view
+    },
+  ],
+});
+```
+
+Add blueprints to your config:
+
+```typescript
+import { defineConfig } from "@antlur/backstage";
+import { customerBlueprint } from "./blueprints/customer";
+
+export default defineConfig({
+  accountId: process.env.BACKSTAGE_ACCOUNT_ID,
+  token: process.env.BACKSTAGE_API_KEY,
+  blueprints: [customerBlueprint],
+});
+```
+
+## Using Reference Fields
+
+Reference fields allow you to link to entries from specific blueprints. You can constrain which blueprints are allowed:
+
+```typescript
+// blocks/testimonials/schema.ts
+import { defineBlockSchema, defineField } from "@antlur/backstage/studio";
+
+const testimonialFields = [
+  defineField({
+    name: "Customers",
+    slug: "customers",
+    type: "reference",
+    description: "Select customer entries",
+    allowed_references: ["customers"], // Only allow entries from the "customers" blueprint
+    is_multiple: true, // Allow multiple customer selections
+    required: true,
+  }),
+  defineField({
+    name: "Quote",
+    slug: "quote",
+    type: "textarea",
+    description: "The testimonial quote",
+    required: true,
+  }),
+];
+
+export const schema = defineBlockSchema({
+  fields: testimonialFields,
+});
+```
+
+In your component, the reference field will contain the full entry data:
+
+```typescript
+// blocks/testimonials/component.tsx
+import type { BlockComponentProps } from "@antlur/backstage/studio";
+import schema from "./schema";
+
+export default function Testimonials({ block }: BlockComponentProps<typeof schema>) {
+  const { customers, quote } = block.fields;
+
+  return (
+    <div className="testimonial">
+      <blockquote>"{quote}"</blockquote>
+      <cite>
+        - {customers.map(customer => customer.name).join(", ")}
+      </cite> {/* Access entry properties */}
+    </div>
+  );
+}
+```
+
+## Field Options
+
+When defining fields for blocks and blueprints, you can set various options to customize their behavior:
+
+### Common Field Options
+
+- `name` (required): Display name for the field
+- `slug` (required): Unique identifier for the field
+- `type` (required): Field type (see supported types below)
+- `description`: Help text shown to content editors
+- `placeholder`: Placeholder text shown in input fields
+- `required`: Whether the field is required
+- `options`: For select fields, array of `{ label: string, value: any }` options
+- `allowed_references`: For reference fields, array of blueprint slugs to reference
+- `is_multiple`: For reference fields, allow multiple selections
+
+### Blueprint-Specific Options
+
+- `is_primary`: Mark as the primary field (used for display in lists)
+- `show_in_list`: Show this field in admin list views
+- `order`: Display order in forms (number)
+- `type_id`: For fieldset references, the ID of the fieldset
+
 ## CLI Commands
 
-Sync your blocks and layouts to Backstage CMS:
+Sync your blocks, blueprints, and layouts to Backstage CMS:
 
 ```bash
 # Sync blocks only
 npx backstage sync blocks
 
+# Sync blueprints only
+npx backstage sync blueprints
+
 # Sync layouts only
 npx backstage sync layouts
 
@@ -177,6 +360,7 @@ The client provides the following services:
 
 - `client.pages` - Page management
 - `client.blocks` - Block management
+- `client.blueprints` - Blueprint (content type) management
 - `client.layouts` - Layout management
 - `client.locations` - Location management
 - `client.events` - Event management
@@ -190,24 +374,35 @@ The client provides the following services:
 
 ## Field Types
 
-Supported field types for blocks and layouts:
+Supported field types for blocks, blueprints, and layouts:
 
 - `text` - Single-line text input
 - `textarea` - Multi-line text input
 - `rich_text` - Rich text editor
+- `markdown` - Markdown editor
 - `number` - Numeric input
 - `boolean` - Checkbox
+- `select` - Select from predefined options
+- `reference` - Reference to entries from specific blueprints (supports `is_multiple` for multiple selections)
 - `url` - URL input
+- `email` - Email input
+- `slug` - URL slug input
+- `date` - Date picker
+- `time` - Time picker
+- `datetime` - Date and time picker
+- `location` - Location picker
 - `image` - Single image picker
 - `image_list` - Multiple image picker
 - `media` - Media item picker
 - `list_array` - Array of strings
 - `repeater` - Repeatable field group
+- `fieldset` - Grouped fields
 - `event_select` - Event selector
 - `menu_select` - Menu selector
 - `form_select` - Form selector
 - `press_select` - Press release selector
 - `navigation_select` - Navigation selector
+- `page_select` - Page selector
 
 ## React Components
 

package/src/cli/actions/sync-blueprints.ts

@@ -0,0 +1,45 @@
+import type { BackstageUserConfig } from "../../config.js";
+import { BackstageClient } from "../../client.js";
+
+export async function syncBlueprints(config: BackstageUserConfig) {
+  const client = new BackstageClient(config);
+
+  if (!config.blueprints || !config.blueprints.length) {
+    console.log("No blueprints found in config");
+    return;
+  }
+
+  const syncPromises = config.blueprints.map(async (blueprint) => {
+    const blueprintData = {
+      name: blueprint.name,
+      slug: blueprint.slug,
+      slug_single: blueprint.slug_single,
+      description: blueprint.description,
+      is_routable: blueprint.is_routable,
+      has_location: blueprint.has_location,
+      has_route_index: blueprint.has_route_index,
+      fields: blueprint.fields,
+    };
+
+    try {
+      await client.blueprints.create(blueprintData);
+      console.log(`✓ Blueprint ${blueprint.slug} created`);
+    } catch (err: any) {
+      if (err?.response?.status === 409) {
+        const id = err.response.data;
+        console.log(`⚠ Blueprint ${blueprint.slug} already exists with id ${id}. Updating...`);
+        try {
+          await client.blueprints.update(id, blueprintData);
+          console.log(`✓ Blueprint ${blueprint.slug} updated`);
+        } catch (updateErr: any) {
+          console.error(`✗ Failed to update blueprint ${blueprint.slug}:`, updateErr?.message || updateErr);
+        }
+      } else {
+        console.error(`✗ Failed to create blueprint ${blueprint.slug}:`, err?.message || err);
+      }
+    }
+  });
+
+  await Promise.all(syncPromises);
+  console.log(`\nSync complete: ${config.blueprints.length} blueprint(s) processed`);
+}

package/src/cli/cli.ts

@@ -5,6 +5,7 @@ import { resolve } from "path";
 import { program } from "commander";
 import { loadBackstageConfig } from "./load-config.js";
 import { syncBlocks } from "./actions/sync-blocks.js";
+import { syncBlueprints } from "./actions/sync-blueprints.js";
 import { syncLayouts } from "./actions/sync-layouts.js";
 
 config({ path: resolve(process.cwd(), ".env") });
@@ -16,7 +17,7 @@ program
 
 program
   .command("sync <type>")
-  .description("Sync blocks and layouts with the Backstage CMS")
+  .description("Sync blocks, blueprints, and layouts with the Backstage CMS")
   .action(async (type) => {
     const backstageConfig = await loadBackstageConfig();
 
@@ -30,6 +31,11 @@ program
       return;
     }
 
+    if (type === "blueprints") {
+      await syncBlueprints(backstageConfig);
+      return;
+    }
+
     if (type === "layouts") {
       await syncLayouts(backstageConfig);
       return;
@@ -37,11 +43,12 @@ program
 
     if (type === "all") {
       await syncBlocks(backstageConfig);
+      await syncBlueprints(backstageConfig);
       await syncLayouts(backstageConfig);
       return;
     }
 
-    console.error(`Unknown type: ${type}. Valid types are: blocks, layouts, all`);
+    console.error(`Unknown type: ${type}. Valid types are: blocks, blueprints, layouts, all`);
     process.exit(1);
   });
 

package/src/client.ts

@@ -2,6 +2,7 @@ import { getGlobalConfig, BackstageUserConfig } from "./config.js";
 import { AlertService } from "./endpoints/alerts.js";
 import { AuthService } from "./endpoints/auth.js";
 import { BlocksService } from "./endpoints/blocks.js";
+import { BlueprintsService } from "./endpoints/blueprints.js";
 import { EntryService } from "./endpoints/entries.js";
 import { EventService } from "./endpoints/events.js";
 import { FormService } from "./endpoints/forms.js";
@@ -27,6 +28,7 @@ export class BackstageClient {
   public readonly alerts: AlertService;
   public readonly auth: AuthService;
   public readonly blocks: BlocksService;
+  public readonly blueprints: BlueprintsService;
   public readonly entries: EntryService;
   public readonly events: EventService;
   public readonly forms: FormService;
@@ -69,6 +71,7 @@ export class BackstageClient {
     this.alerts = new AlertService(this);
     this.auth = new AuthService(this);
     this.blocks = new BlocksService(this);
+    this.blueprints = new BlueprintsService(this);
     this.entries = new EntryService(this);
     this.events = new EventService(this);
     this.forms = new FormService(this);

package/src/config.ts

@@ -2,11 +2,35 @@ import type { BlockDefinition } from "./studio/types/index.js";
 
 const DEFAULT_BASE_URL = "https://bckstg.app/api";
 
+export interface BlueprintDefinition {
+  name: string;
+  slug: string;
+  slug_single?: string;
+  description?: string;
+  is_routable?: boolean;
+  has_location?: boolean;
+  has_route_index?: boolean;
+  fields: Array<{
+    name: string;
+    slug: string;
+    type: string;
+    type_id?: string | null;
+    is_primary?: boolean;
+    is_multiple?: boolean;
+    show_in_list?: boolean;
+    order: number;
+    allowed_references?: string[];
+    options?: Array<{ label: string; value: any }>;
+    placeholder?: string;
+  }>;
+}
+
 export interface BackstageUserConfig {
   accountId?: string | undefined;
   token?: string | undefined;
   baseURL?: string;
   blocks?: BlockDefinition<any>[] | undefined;
+  blueprints?: BlueprintDefinition[] | undefined;
   layouts?: any[] | undefined;
   onError?: (error: Error) => void;
 }

package/src/endpoints/blueprints.ts

@@ -0,0 +1,58 @@
+import type { ApiCollectionResponse, ApiSingleResponse } from "../types/index";
+import type { Blueprint } from "../types/blueprint";
+import { BaseService } from "./base.js";
+
+export interface CreateBlueprintParams {
+  name: string;
+  slug: string;
+  slug_single?: string;
+  description?: string;
+  is_routable?: boolean;
+  has_location?: boolean;
+  has_route_index?: boolean;
+  fields: Array<{
+    name: string;
+    slug: string;
+    type: string;
+    type_id?: string | null;
+    is_primary?: boolean;
+    is_multiple?: boolean;
+    show_in_list?: boolean;
+    order: number;
+    allowed_references?: string[];
+    options?: Array<{ label: string; value: any }>;
+    placeholder?: string;
+  }>;
+}
+
+export interface UpdateBlueprintParams extends Partial<CreateBlueprintParams> {}
+
+export class BlueprintsService extends BaseService {
+  async list(options?: RequestInit): Promise<Blueprint[]> {
+    const { data } = await this.client.get<ApiCollectionResponse<Blueprint>>("/blueprints", options);
+    return data;
+  }
+
+  async get(id: string, options?: RequestInit): Promise<Blueprint | null> {
+    try {
+      const { data } = await this.client.get<ApiSingleResponse<Blueprint>>(`/blueprints/${id}`, options);
+      return data;
+    } catch (error) {
+      return null;
+    }
+  }
+
+  async create(params: CreateBlueprintParams, options?: RequestInit): Promise<Blueprint> {
+    const { data } = await this.client.post<ApiSingleResponse<Blueprint>>("/blueprints", params, options);
+    return data;
+  }
+
+  async update(id: string, params: UpdateBlueprintParams, options?: RequestInit): Promise<Blueprint> {
+    const { data } = await this.client.put<ApiSingleResponse<Blueprint>>(`/blueprints/${id}`, params, options);
+    return data;
+  }
+
+  async delete(id: string, options?: RequestInit): Promise<void> {
+    await this.client.delete(`/blueprints/${id}`, options);
+  }
+}

package/src/index.ts

@@ -8,6 +8,7 @@ export { BackstageClient } from "./client.js";
 export * from "./endpoints/alerts.js";
 export * from "./endpoints/auth.js";
 export * from "./endpoints/blocks.js";
+export * from "./endpoints/blueprints.js";
 export * from "./endpoints/entries.js";
 export * from "./endpoints/events.js";
 export * from "./endpoints/forms.js";

package/src/studio/define-blueprint.ts

@@ -0,0 +1,5 @@
+import type { BlueprintDefinition } from "../config.js";
+
+export function defineBlueprint(blueprint: BlueprintDefinition): BlueprintDefinition {
+  return blueprint;
+}

package/src/studio/index.ts

@@ -1,6 +1,7 @@
 export * from "./types";
 
 export * from "./define-block";
+export * from "./define-blueprint";
 export * from "./define-field";
 export * from "./define-layout";
 export * from "./define-schema";

package/src/studio/types/block.ts

@@ -1,11 +1,20 @@
 import { Field, FieldType, FieldTypeToValue } from "./field";
+import { Entry } from "../../types/entry";
+
+type Nullable<T> = T | null;
 
 // Type for field values from array-based fields
 type FieldValues<T extends readonly Field[]> = {
-  [K in T[number]["slug"]]: Extract<T[number], { slug: K }> extends { type: infer Type }
-    ? Type extends FieldType
-      ? FieldTypeToValue[Type]
-      : never
+  [K in T[number]["slug"]]: Extract<T[number], { slug: K }> extends infer FieldDef
+    ? FieldDef extends { type: 'reference'; is_multiple: true }
+      ? Nullable<Entry[]>
+      : FieldDef extends { type: 'reference' }
+        ? Nullable<Entry>
+        : FieldDef extends { type: infer Type }
+          ? Type extends FieldType
+            ? FieldTypeToValue[Type]
+            : never
+          : never
     : never;
 };
 

package/src/studio/types/field.ts

@@ -1,24 +1,36 @@
 import { MediaItem } from "../../types";
+import { Entry } from "../../types/entry";
 
 type Nullable<T> = T | null;
 
 export type FieldTypeToValue = {
   boolean: Nullable<boolean>;
+  date: Nullable<string>;
+  datetime: Nullable<string>;
+  email: Nullable<string>;
   event_select: Nullable<string>;
+  fieldset: never;
   form_select: Nullable<string>;
   image: Nullable<MediaItem>;
   image_list: Nullable<MediaItem[]>;
+  json: Nullable<any>;
   list_array: Nullable<string[]>;
+  location: Nullable<string>;
+  markdown: Nullable<string>;
   media: Nullable<MediaItem>;
   menu_select: Nullable<string>;
   number: Nullable<number>;
   press_select: Nullable<string>;
+  reference: Nullable<Entry | Entry[]>;
   repeater: Nullable<any[]>;
   rich_text: Nullable<string>;
+  select: Nullable<string>;
   separator: never;
+  slug: Nullable<string>;
   spacer: never;
   text: Nullable<string>;
   textarea: Nullable<string>;
+  time: Nullable<string>;
   url: Nullable<string>;
   navigation_select: Nullable<string>;
   page_select: Nullable<string>;
@@ -32,14 +44,26 @@ export type BaseField = {
   placeholder?: string;
   required?: boolean;
   options?: Array<{ label: string; value: any }>;
+  allowed_references?: string[];
+  is_multiple?: boolean;
+  is_primary?: boolean;
+  show_in_list?: boolean;
+  order?: number;
+  type_id?: string | null;
   fields?: Field[];
 };
 
 export type Field = {
-  [K in FieldType]: BaseField & {
-    type: K;
-    value?: FieldTypeToValue[K];
-  };
+  [K in FieldType]: K extends 'reference'
+    ? BaseField & {
+        type: K;
+        value?: FieldTypeToValue[K];
+        is_multiple?: boolean;
+      }
+    : BaseField & {
+        type: K;
+        value?: FieldTypeToValue[K];
+      };
 }[FieldType];
 
 // export interface Field<T extends FieldType = FieldType> {

package/src/studio/types/layout.ts

@@ -1,11 +1,20 @@
 import { Field, FieldType, FieldTypeToValue } from "./field";
+import { Entry } from "../../types/entry";
+
+type Nullable<T> = T | null;
 
 // Type for field values from array-based fields
 type FieldValues<T extends readonly Field[]> = {
-  [K in T[number]["slug"]]: Extract<T[number], { slug: K }> extends { type: infer Type }
-    ? Type extends FieldType
-      ? FieldTypeToValue[Type]
-      : never
+  [K in T[number]["slug"]]: Extract<T[number], { slug: K }> extends infer FieldDef
+    ? FieldDef extends { type: 'reference'; is_multiple: true }
+      ? Nullable<Entry[]>
+      : FieldDef extends { type: 'reference' }
+        ? Nullable<Entry>
+        : FieldDef extends { type: infer Type }
+          ? Type extends FieldType
+            ? FieldTypeToValue[Type]
+            : never
+          : never
     : never;
 };
 

package/src/types/blueprint.ts

@@ -1,10 +1,32 @@
+export interface BlueprintField {
+  id: string;
+  blueprint_id: string;
+  name: string;
+  slug: string;
+  type: string;
+  type_id: string | null;
+  is_primary: boolean;
+  is_multiple: boolean;
+  show_in_list: boolean;
+  order: number;
+  allowed_references: string[] | null;
+  options: Array<{ label: string; value: any }> | null;
+  placeholder: string | null;
+  created_at: string;
+  updated_at: string;
+}
+
 export interface Blueprint {
   id: string;
   account_id: string;
   name: string;
   slug: string;
+  slug_single: string;
   description: string | null;
-  schema: any;
+  is_routable: boolean;
+  has_location: boolean;
+  has_route_index: boolean;
+  fields: BlueprintField[];
   created_at: string;
   updated_at: string;
 }