@proteos/sdk 0.20.5 → 0.22.0

package/dist/{types-BNsjfU8N.d.ts → types-DT29DVEj.d.ts}

@@ -71,6 +71,12 @@ declare function resolveOptions(options: ClientOptions): ResolvedClientOptions;
 interface RequestOptions {
     /** Request timeout in milliseconds (overrides client default) */
     timeout?: number;
+    /**
+     * Skip attaching the Authorization header. Only meaningful for the public,
+     * unauthenticated endpoints (`/meta/v1/public/*`, `/functions/v1/public/*`)
+     * — every other endpoint 401s without a bearer.
+     */
+    skipAuth?: boolean;
     /** Additional headers for this request */
     headers?: Record<string, string>;
     /** AbortSignal for request cancellation */
@@ -669,6 +675,36 @@ interface ComponentService {
     bundleUrl(slug: string): string;
 }
 
+/**
+ * Service for managing an org's stored DESIGN.md documents (design references).
+ *
+ * The markdown body is split from the metadata methods: list/get never carry
+ * `content` — read it with {@link getContent} and write it with
+ * {@link setContent} (create may seed it in one shot).
+ */
+interface DesignReferenceService {
+    /** Lists design references (metadata only — no `content`). */
+    list(options?: ListDesignReferencesOptions): PageIterator<DesignReference, ListDesignReferencesOptions>;
+    /** Fetches a single page of design references (metadata only). */
+    listPage(options?: ListDesignReferencesOptions): Promise<ListResult<DesignReference>>;
+    /** Gets a single design reference by id (metadata only — no `content`). */
+    get(id: string): Promise<DesignReference>;
+    /** Resolves a design reference by its per-org slug (metadata only). */
+    getBySlug(slug: string): Promise<DesignReference>;
+    /** Creates a design reference; `content` optionally seeds the body. */
+    create(request: CreateDesignReferenceRequest): Promise<DesignReference>;
+    /** Creates or (by slug) replaces a design reference, including its body. */
+    upsert(request: CreateDesignReferenceRequest): Promise<DesignReference>;
+    /** Updates a design reference's metadata (name/description/slug). */
+    update(id: string, request: UpdateDesignReferenceRequest): Promise<DesignReference>;
+    /** Deletes a design reference. */
+    delete(id: string): Promise<void>;
+    /** Reads the markdown body for a design reference. */
+    getContent(id: string): Promise<string>;
+    /** Overwrites the markdown body for a design reference (metadata untouched). */
+    setContent(id: string, content: string): Promise<void>;
+}
+
 /**
  * Service for managing entity definitions.
  * Entities define the structure of business objects in the system.
@@ -734,6 +770,12 @@ interface EntityService {
      * @throws {ProteosError} If entity not found (404)
      */
     getWithSchema(slug: string): Promise<EntityWithSchema>;
+    /**
+     * Gets a public-access (read) entity (with schema) through the UNAUTHENTICATED
+     * public endpoint — no Authorization header. A non-public or missing
+     * entity 404s identically.
+     */
+    getPublic(orgId: string, slug: string): Promise<EntityWithSchema>;
     /**
      * Creates a new entity.
      *
@@ -1070,6 +1112,17 @@ interface PageService {
      * @throws {ProteosError} If page not found (404)
      */
     get(slug: string): Promise<Page>;
+    /**
+     * Gets a PUBLIC page (type='public') without authentication — no
+     * Authorization header is sent. Returns the page plus the props_schema of
+     * every component its layout references. Non-public pages 404
+     * (indistinguishable from absent).
+     *
+     * @param orgId - Org id (public routes carry the org in the path — there is
+     *   no token to scope from)
+     * @param slug - Page slug
+     */
+    getPublic(orgId: string, slug: string): Promise<PublicPageResponse>;
     /**
      * Creates a new page.
      *
@@ -1570,6 +1623,10 @@ declare class MetaClient {
      * Service for managing apps.
      */
     readonly apps: AppService;
+    /**
+     * Service for managing design references (stored DESIGN.md documents).
+     */
+    readonly designReferences: DesignReferenceService;
     /**
      * Creates a new MetaClient instance.
      *
@@ -1862,6 +1919,12 @@ declare function parseUserMeta(attr: Attribute): UserAttributeMeta | null;
  * with no meta still resolves to an empty `{}` rather than null.
  */
 declare function parseFileMeta(attr: Attribute): FileAttributeMeta | null;
+/**
+ * A single operation a resource may be publicly exposed for. Independent set
+ * (not a level): a resource can be public for `write` without `read`. Only
+ * `read` is honored on the platform today; `write`/`delete` are reserved.
+ */
+type PublicAccessOperation = 'read' | 'write' | 'delete';
 /**
  * Entity definition.
  * Note: Entity uses `slug` as its primary identifier, not `id`.
@@ -1871,6 +1934,14 @@ interface Entity extends AuditFields {
     name: string;
     description: string;
     is_remote: boolean;
+    /**
+     * Operations ALL records of the entity are exposed for on the
+     * unauthenticated public surface. Only `["read"]` is honored today (records
+     * become world-readable; the entity definition is implicitly readable so
+     * they can be interpreted); `write`/`delete` are reserved. Empty = private
+     * (default).
+     */
+    public_record_access: PublicAccessOperation[];
     module_slug: string;
     /**
      * Liquid template that renders a human-readable title for an instance
@@ -1912,6 +1983,7 @@ declare const EntitySchema: z.ZodObject<{
     name: z.ZodString;
     description: z.ZodString;
     is_remote: z.ZodBoolean;
+    public_record_access: z.ZodDefault<z.ZodArray<z.ZodEnum<["read", "write", "delete"]>, "many">>;
     module_slug: z.ZodString;
     title_template: z.ZodDefault<z.ZodString>;
     attributes: z.ZodArray<z.ZodObject<{
@@ -1979,6 +2051,7 @@ declare const EntitySchema: z.ZodObject<{
     }[];
     slug: string;
     is_remote: boolean;
+    public_record_access: ("read" | "write" | "delete")[];
     module_slug: string;
     title_template: string;
 }, {
@@ -2010,6 +2083,7 @@ declare const EntitySchema: z.ZodObject<{
     slug: string;
     is_remote: boolean;
     module_slug: string;
+    public_record_access?: ("read" | "write" | "delete")[] | undefined;
     title_template?: string | undefined;
 }>;
 /**
@@ -2046,6 +2120,7 @@ declare const EntityWithSchemaSchema: z.ZodObject<{
     name: z.ZodString;
     description: z.ZodString;
     is_remote: z.ZodBoolean;
+    public_record_access: z.ZodDefault<z.ZodArray<z.ZodEnum<["read", "write", "delete"]>, "many">>;
     module_slug: z.ZodString;
     title_template: z.ZodDefault<z.ZodString>;
     attributes: z.ZodArray<z.ZodObject<{
@@ -2115,6 +2190,7 @@ declare const EntityWithSchemaSchema: z.ZodObject<{
     }[];
     slug: string;
     is_remote: boolean;
+    public_record_access: ("read" | "write" | "delete")[];
     module_slug: string;
     title_template: string;
     schema: Record<string, unknown>;
@@ -2148,6 +2224,7 @@ declare const EntityWithSchemaSchema: z.ZodObject<{
     is_remote: boolean;
     module_slug: string;
     schema: Record<string, unknown>;
+    public_record_access?: ("read" | "write" | "delete")[] | undefined;
     title_template?: string | undefined;
 }>;
 /**
@@ -2166,6 +2243,12 @@ interface CreateEntityRequest {
     slug: string;
     name: string;
     is_remote: boolean;
+    /**
+     * Operations to expose all records of the entity for, unauthenticated (only
+     * `["read"]` accepted today). Full-replacement on upsert: an upsert without
+     * the field resets it to private.
+     */
+    public_record_access?: PublicAccessOperation[];
     module_slug: string;
     description: string;
     title_template?: string;
@@ -2177,6 +2260,7 @@ interface CreateEntityRequest {
 interface UpdateEntityRequest {
     name?: string;
     is_remote?: boolean;
+    public_record_access?: PublicAccessOperation[];
     module_slug?: string;
     description?: string;
     title_template?: string;
@@ -2404,6 +2488,13 @@ interface Component extends AuditFields {
     source_file_id: string;
     /** The component's JSON Schema, driving the page-designer props editor + runtime validation. `null` until set. */
     props_schema: Record<string, unknown> | null;
+    /**
+     * Opts the compiled bundle into UNAUTHENTICATED serving. Public
+     * (type='public') pages may only reference public components (enforced at
+     * page save), and a public component's only platform reach at runtime is
+     * `functions.actions.invokePublic`.
+     */
+    is_public: boolean;
 }
 declare const ComponentSchema: z.ZodObject<{
     created_at: z.ZodString;
@@ -2436,6 +2527,7 @@ declare const ComponentSchema: z.ZodObject<{
     bundle_file_id: z.ZodString;
     source_file_id: z.ZodString;
     props_schema: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    is_public: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     created_at: string;
@@ -2454,6 +2546,7 @@ declare const ComponentSchema: z.ZodObject<{
     bundle_file_id: string;
     source_file_id: string;
     props_schema: Record<string, unknown> | null;
+    is_public: boolean;
 }, {
     name: string;
     created_at: string;
@@ -2472,6 +2565,7 @@ declare const ComponentSchema: z.ZodObject<{
     bundle_file_id: string;
     source_file_id: string;
     props_schema: Record<string, unknown> | null;
+    is_public?: boolean | undefined;
 }>;
 /**
  * Options for listing components.
@@ -2492,6 +2586,8 @@ interface CreateComponentRequest {
     bundle_file_id?: string;
     source_file_id?: string;
     props_schema?: Record<string, unknown>;
+    /** See {@link Component.is_public}. Manifest-driven: omitting it sets false. */
+    is_public?: boolean;
 }
 /**
  * Request to update a component.
@@ -2502,6 +2598,7 @@ interface UpdateComponentRequest {
     bundle_file_id?: string;
     source_file_id?: string;
     props_schema?: Record<string, unknown>;
+    is_public?: boolean;
 }
 /**
  * List column definition.
@@ -2865,12 +2962,19 @@ declare const PageActionSchema: z.ZodObject<{
     action: string;
 }>;
 /**
- * Page type. `record` pages render against a single record of `entity_slug`;
- * `platform` pages are standalone (no record context — e.g. a dashboard
- * launched from a menu item). `external` is reserved for a future chromeless
- * variant and is not yet accepted by the API.
+ * Page type — encodes what the page binds to and how it is served (chrome +
+ * auth posture both follow from it):
+ *
+ * - `record`:   rendered against a single record of `entity_slug`; app chrome;
+ *   authenticated.
+ * - `platform`: standalone, no record context (e.g. a dashboard launched from
+ *   a menu item); app chrome; authenticated.
+ * - `kiosk`:    standalone, NO app chrome (bare page at `/k/…`); authenticated.
+ * - `public`:   standalone, NO app chrome (bare page at `/p/…`);
+ *   UNAUTHENTICATED — the layout is world-readable and its components may only
+ *   call `is_public` global actions.
  */
-type PageType = 'record' | 'platform';
+type PageType = 'record' | 'platform' | 'kiosk' | 'public';
 /**
  * Page configuration. A `record` page is the detail-page shape for a single
  * entity; a `platform` page is standalone (no entity, no record).
@@ -2916,7 +3020,7 @@ declare const PageSchema: z.ZodObject<{
     slug: z.ZodString;
     name: z.ZodString;
     module_slug: z.ZodString;
-    type: z.ZodEnum<["record", "platform"]>;
+    type: z.ZodEnum<["record", "platform", "kiosk", "public"]>;
     entity_slug: z.ZodOptional<z.ZodString>;
     actions: z.ZodArray<z.ZodObject<{
         label: z.ZodString;
@@ -2965,7 +3069,7 @@ declare const PageSchema: z.ZodObject<{
         } | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
-    type: "platform" | "record";
+    type: "platform" | "record" | "kiosk" | "public";
     name: string;
     created_at: string;
     updated_at: string;
@@ -2995,7 +3099,7 @@ declare const PageSchema: z.ZodObject<{
     };
     entity_slug?: string | undefined;
 }, {
-    type: "platform" | "record";
+    type: "platform" | "record" | "kiosk" | "public";
     name: string;
     created_at: string;
     updated_at: string;
@@ -3025,6 +3129,24 @@ declare const PageSchema: z.ZodObject<{
     };
     entity_slug?: string | undefined;
 }>;
+/**
+ * Component metadata slice riding on the public page payload — just the slug
+ * and props schema (deliberately not the full Component: this is served
+ * unauthenticated).
+ */
+interface PublicPageComponent {
+    slug: string;
+    props_schema?: Record<string, unknown>;
+}
+/**
+ * Payload of the unauthenticated `GET /meta/v1/public/orgs/{orgId}/pages/{slug}`:
+ * the page plus the props_schema of every component its layout references, so
+ * a public renderer needs no follow-up authenticated calls.
+ */
+interface PublicPageResponse {
+    page: Page;
+    components: PublicPageComponent[];
+}
 /**
  * Options for listing pages.
  */
@@ -3295,5 +3417,117 @@ interface UpdateAppRequest {
     description?: string;
     icon_slug?: string;
 }
+/**
+ * A stored DESIGN.md document — a named design reference an org authors and that
+ * design agents read as the source of truth for a surface. `name` + `description`
+ * are the selector ("which reference, and when to use it").
+ *
+ * `content` (the markdown body) is NOT returned by list/get — fetch it via
+ * {@link DesignReferenceService.getContent} and write it via `setContent`.
+ */
+interface DesignReference extends AuditFields {
+    id: string;
+    org_id: string;
+    slug: string;
+    name: string;
+    description: string;
+    /** The DESIGN.md body. Only present on the dedicated content endpoint; undefined on list/get. */
+    content?: string;
+}
+declare const DesignReferenceSchema: z.ZodObject<{
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+    created_by: z.ZodObject<{
+        type: z.ZodEnum<["person", "agent", "api"]>;
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "person" | "agent" | "api";
+        id: string;
+    }, {
+        type: "person" | "agent" | "api";
+        id: string;
+    }>;
+    updated_by: z.ZodObject<{
+        type: z.ZodEnum<["person", "agent", "api"]>;
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "person" | "agent" | "api";
+        id: string;
+    }, {
+        type: "person" | "agent" | "api";
+        id: string;
+    }>;
+} & {
+    id: z.ZodString;
+    slug: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    content: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    created_at: string;
+    updated_at: string;
+    created_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    updated_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    description: string;
+    slug: string;
+    content?: string | undefined;
+}, {
+    id: string;
+    name: string;
+    created_at: string;
+    updated_at: string;
+    created_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    updated_by: {
+        type: "person" | "agent" | "api";
+        id: string;
+    };
+    description: string;
+    slug: string;
+    content?: string | undefined;
+}>;
+/**
+ * Options for listing design references.
+ */
+interface ListDesignReferencesOptions extends MetaListOptions {
+    id?: string;
+    slug?: string;
+    name?: string;
+    description?: string;
+}
+/**
+ * Request to create a design reference. `content` optionally seeds the body.
+ */
+interface CreateDesignReferenceRequest {
+    slug: string;
+    name: string;
+    description?: string;
+    content?: string;
+}
+/**
+ * Request to update a design reference's metadata. Content is edited via the
+ * dedicated content endpoint, not here.
+ */
+interface UpdateDesignReferenceRequest {
+    slug?: string;
+    name?: string;
+    description?: string;
+}
+/**
+ * The markdown body, from GET/PUT /design-references/:id/content.
+ */
+interface DesignReferenceContent {
+    content: string;
+}
 
-export { type ListFn as $, type AuditFields as A, type CurrencyValue as B, type ClientOptions as C, DEFAULT_OPTIONS as D, DEFAULT_PAGE_SIZE as E, type FileRef as F, DONE as G, type DeployModuleRequest as H, type Done as I, type Entity as J, EntitySchema as K, type ListOptions as L, type EntityService as M, type EntityWithSchema as N, EntityWithSchemaSchema as O, PageIterator as P, type FileAttributeMeta as Q, FileRefSchema as R, type FilterElement as S, FilterElementSchema as T, type UserRef as U, type FilterGroup as V, FilterGroupSchema as W, type List as X, type ListAppsOptions as Y, type ListComponentsOptions as Z, type ListEntitiesOptions as _, type Attribute as a, currencySymbol as a$, type ListListViewsOptions as a0, type ListListsOptions as a1, type ListMenuConfigurationsOptions as a2, type ListModulesOptions as a3, type ListPagesOptions as a4, ListSchema as a5, type ListService as a6, type ListVariablesOptions as a7, type ListView as a8, ListViewSchema as a9, RelationAttributeMetaSchema as aA, type RequestOptions as aB, type ResolvedClientOptions as aC, type ResponseMeta as aD, ResponseMetaSchema as aE, type SortConfig as aF, SortConfigSchema as aG, type SortDirection as aH, type Timestamps as aI, type TokenProvider as aJ, type UpdateAppRequest as aK, type UpdateComponentRequest as aL, type UpdateEntityRequest as aM, type UpdateListRequest as aN, type UpdateListViewRequest as aO, type UpdateMenuConfigurationRequest as aP, type UpdatePageRequest as aQ, type UpdateVariableRequest as aR, UserRefSchema as aS, type UserType as aT, type Variable as aU, VariableSchema as aV, type VariableService as aW, allCurrencyCodes as aX, createIterator as aY, createListResultSchema as aZ, currencyLabel as a_, type ListViewService as aa, type LogicalOperator as ab, type MenuConfiguration as ac, MenuConfigurationSchema as ad, type MenuConfigurationService as ae, type MenuItem as af, MenuItemSchema as ag, MenuItemType as ah, MetaClient as ai, type MetaListOptions as aj, type Module as ak, ModuleSchema as al, type ModuleService as am, type ModuleStatus as an, type OnDeleteAction as ao, OnDeleteActionSchema as ap, PLATFORM_ATTRIBUTE_NAMES as aq, PLATFORM_USER_ID as ar, type Page as as, type PageAction as at, PageActionSchema as au, type PageLayout as av, PageLayoutSchema as aw, PageSchema as ax, type PageService as ay, type RelationAttributeMeta as az, type ListResult as b, currencySymbolSide as b0, formatAmount as b1, formatMoney as b2, isPlatformAttributeName as b3, localeNumberSeparators as b4, parseAmount as b5, parseCurrencyMeta as b6, parseFileMeta as b7, parseRelationMeta as b8, platformAttributes as b9, type PageLayoutSidePanel as bA, PageLayoutSidePanelSchema as bB, type RelatedListElement as bC, type ResponsiveSizing as bD, type RowElement as bE, type SectionElement as bF, type SizeValue as bG, SizeValueSchema as bH, type SizingProps as bI, type StringAttributeMeta as bJ, type StringFormat as bK, type TabsElement as bL, type TextElement as bM, type TextVariant as bN, type UserAttributeMeta as bO, UserAttributeMetaSchema as bP, isBuiltInControl as bQ, lookupCompatibleControls as bR, lookupControls as bS, lookupPrimaryControl as bT, parseUserMeta as bU, resolveOptions as ba, type ArrayAttributeMeta as bb, type AttributeForLookup as bc, type AttributeMeta as bd, BUILT_IN_CONTROLS as be, type BuiltInControlSlug as bf, type ColumnElement as bg, type CommonProps as bh, type ComponentElement as bi, type ControlBucket as bj, type DatetimeAttributeMeta as bk, type DatetimeFormat as bl, type DividerElement as bm, type EnumAttributeMeta as bn, type EnumValue as bo, type FieldElement as bp, FileAttributeMetaSchema as bq, type LayoutAlign as br, type LayoutElement as bs, LayoutElementSchema as bt, LayoutElementType as bu, type LayoutGap as bv, type LayoutJustify as bw, type LayoutTab as bx, type NumberAttributeMeta as by, type ObjectAttributeMeta as bz, ProteosClient as c, type App as d, AppSchema as e, type AppService as f, AttributeSchema as g, type AttributeType as h, AuditFieldsSchema as i, type Column as j, ColumnSchema as k, type ComparisonOperator as l, type Component as m, ComponentSchema as n, type ComponentService as o, type CreateAppRequest as p, type CreateComponentRequest as q, type CreateEntityRequest as r, type CreateListRequest as s, type CreateListViewRequest as t, type CreateMenuConfigurationRequest as u, type CreatePageRequest as v, type CreateVariableRequest as w, type CurrencyAttributeMeta as x, CurrencyAttributeMetaSchema as y, type CurrencySymbolSide as z };
+export { type FilterGroup as $, type AuditFields as A, CurrencyAttributeMetaSchema as B, type ClientOptions as C, type CurrencySymbolSide as D, type CurrencyValue as E, type FileRef as F, DEFAULT_OPTIONS as G, DEFAULT_PAGE_SIZE as H, DONE as I, type DeployModuleRequest as J, type DesignReference as K, type ListOptions as L, type DesignReferenceContent as M, DesignReferenceSchema as N, type DesignReferenceService as O, PageIterator as P, type Done as Q, type Entity as R, EntitySchema as S, type EntityService as T, type UserRef as U, type EntityWithSchema as V, EntityWithSchemaSchema as W, type FileAttributeMeta as X, FileRefSchema as Y, type FilterElement as Z, FilterElementSchema as _, type Attribute as a, type UpdatePageRequest as a$, FilterGroupSchema as a0, type List as a1, type ListAppsOptions as a2, type ListComponentsOptions as a3, type ListDesignReferencesOptions as a4, type ListEntitiesOptions as a5, type ListFn as a6, type ListListViewsOptions as a7, type ListListsOptions as a8, type ListMenuConfigurationsOptions as a9, type PageAction as aA, PageActionSchema as aB, type PageLayout as aC, PageLayoutSchema as aD, PageSchema as aE, type PageService as aF, type PageType as aG, type PublicPageComponent as aH, type PublicPageResponse as aI, type RelationAttributeMeta as aJ, RelationAttributeMetaSchema as aK, type RequestOptions as aL, type ResolvedClientOptions as aM, type ResponseMeta as aN, ResponseMetaSchema as aO, type SortConfig as aP, SortConfigSchema as aQ, type SortDirection as aR, type Timestamps as aS, type TokenProvider as aT, type UpdateAppRequest as aU, type UpdateComponentRequest as aV, type UpdateDesignReferenceRequest as aW, type UpdateEntityRequest as aX, type UpdateListRequest as aY, type UpdateListViewRequest as aZ, type UpdateMenuConfigurationRequest as a_, type ListModulesOptions as aa, type ListPagesOptions as ab, ListSchema as ac, type ListService as ad, type ListVariablesOptions as ae, type ListView as af, ListViewSchema as ag, type ListViewService as ah, type LogicalOperator as ai, type MenuConfiguration as aj, MenuConfigurationSchema as ak, type MenuConfigurationService as al, type MenuItem as am, MenuItemSchema as an, MenuItemType as ao, MetaClient as ap, type MetaListOptions as aq, type Module as ar, ModuleSchema as as, type ModuleService as at, type ModuleStatus as au, type OnDeleteAction as av, OnDeleteActionSchema as aw, PLATFORM_ATTRIBUTE_NAMES as ax, PLATFORM_USER_ID as ay, type Page as az, type ListResult as b, isBuiltInControl as b$, type UpdateVariableRequest as b0, UserRefSchema as b1, type UserType as b2, type Variable as b3, VariableSchema as b4, type VariableService as b5, allCurrencyCodes as b6, createIterator as b7, createListResultSchema as b8, currencyLabel as b9, type FieldElement as bA, FileAttributeMetaSchema as bB, type LayoutAlign as bC, type LayoutElement as bD, LayoutElementSchema as bE, LayoutElementType as bF, type LayoutGap as bG, type LayoutJustify as bH, type LayoutTab as bI, type NumberAttributeMeta as bJ, type ObjectAttributeMeta as bK, type PageLayoutSidePanel as bL, PageLayoutSidePanelSchema as bM, type RelatedListElement as bN, type ResponsiveSizing as bO, type RowElement as bP, type SectionElement as bQ, type SizeValue as bR, SizeValueSchema as bS, type SizingProps as bT, type StringAttributeMeta as bU, type StringFormat as bV, type TabsElement as bW, type TextElement as bX, type TextVariant as bY, type UserAttributeMeta as bZ, UserAttributeMetaSchema as b_, currencySymbol as ba, currencySymbolSide as bb, formatAmount as bc, formatMoney as bd, isPlatformAttributeName as be, localeNumberSeparators as bf, parseAmount as bg, parseCurrencyMeta as bh, parseFileMeta as bi, parseRelationMeta as bj, platformAttributes as bk, resolveOptions as bl, type ArrayAttributeMeta as bm, type AttributeForLookup as bn, type AttributeMeta as bo, BUILT_IN_CONTROLS as bp, type BuiltInControlSlug as bq, type ColumnElement as br, type CommonProps as bs, type ComponentElement as bt, type ControlBucket as bu, type DatetimeAttributeMeta as bv, type DatetimeFormat as bw, type DividerElement as bx, type EnumAttributeMeta as by, type EnumValue as bz, ProteosClient as c, lookupCompatibleControls as c0, lookupControls as c1, lookupPrimaryControl as c2, parseUserMeta as c3, type PublicAccessOperation as d, type App as e, AppSchema as f, type AppService as g, AttributeSchema as h, type AttributeType as i, AuditFieldsSchema as j, type Column as k, ColumnSchema as l, type ComparisonOperator as m, type Component as n, ComponentSchema as o, type ComponentService as p, type CreateAppRequest as q, type CreateComponentRequest as r, type CreateDesignReferenceRequest as s, type CreateEntityRequest as t, type CreateListRequest as u, type CreateListViewRequest as v, type CreateMenuConfigurationRequest as w, type CreatePageRequest as x, type CreateVariableRequest as y, type CurrencyAttributeMeta as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proteos/sdk",
-  "version": "0.20.5",
+  "version": "0.22.0",
   "license": "Apache-2.0",
   "description": "TypeScript SDK for the Proteos platform",
   "repository": {

package/src/auth/platform-entities.ts

@@ -30,6 +30,7 @@ export const PLATFORM_ENTITIES: readonly PlatformEntity[] = [
   { slug: 'components', name: 'Components' },
   { slug: 'lists', name: 'Lists' },
   { slug: 'list-views', name: 'List Views' },
+  { slug: 'design-references', name: 'Design References' },
   // System (metadata-service)
   { slug: 'modules', name: 'Modules' },
   { slug: 'variables', name: 'Variables' },
@@ -39,6 +40,9 @@ export const PLATFORM_ENTITIES: readonly PlatformEntity[] = [
   // Automation (function-service)
   { slug: 'hooks', name: 'Hooks' },
   { slug: 'actions', name: 'Actions' },
+  // Workflows (workflow-service)
+  { slug: 'workflows', name: 'Workflows' },
+  { slug: 'workflow-executions', name: 'Workflow Executions' },
   // Knowledge (knowledge-service)
   { slug: 'knowledge-nodes', name: 'Knowledge Nodes' },
   { slug: 'knowledge-links', name: 'Knowledge Links' },

package/src/client.ts

@@ -91,9 +91,11 @@ export class ProteosClient {
       ...requestOptions?.headers,
     })
 
-    const token = await this.getToken()
-    if (token) {
-      headers.set('Authorization', `Bearer ${token}`)
+    if (!requestOptions?.skipAuth) {
+      const token = await this.getToken()
+      if (token) {
+        headers.set('Authorization', `Bearer ${token}`)
+      }
     }
 
     return headers

package/src/data/records.ts

@@ -10,6 +10,7 @@ import type {
 
 const RECORDS_BASE_PATH = '/data/v1/records'
 const BATCH_RECORDS_BASE_PATH = '/data/v1/batch/records'
+const PUBLIC_RECORDS_BASE_PATH = '/data/v1/public/orgs'
 
 /**
  * Service for managing records (per-entity data rows) via the data-service.
@@ -63,6 +64,34 @@ export interface RecordService {
     entitySlug: string,
     transactions: BatchUpsertTransaction[],
   ): Promise<BatchUpsertRecordsResponse>
+
+  /**
+   * Lists records of a public-read entity through the UNAUTHENTICATED
+   * public endpoint (no Authorization header) as an async iterator. A
+   * non-public or missing entity 404s identically.
+   */
+  listPublic(
+    orgId: string,
+    entitySlug: string,
+    options?: ListRecordsOptions,
+  ): PageIterator<RecordData, ListRecordsOptions>
+
+  /**
+   * Fetches a single page of records through the unauthenticated public
+   * endpoint. Same filter grammar and pagination as `listPage`.
+   */
+  listPublicPage(
+    orgId: string,
+    entitySlug: string,
+    options?: ListRecordsOptions,
+  ): Promise<ListResult<RecordData>>
+
+  /**
+   * Gets a single record of a public-read entity through the
+   * unauthenticated public endpoint. Knowledge-text values stay unenriched
+   * (bare refs) on this path.
+   */
+  getPublic(orgId: string, entitySlug: string, id: string): Promise<RecordData>
 }
 
 /**
@@ -119,4 +148,35 @@ export class RecordServiceImpl implements RecordService {
       transactions,
     )
   }
+
+  listPublic(
+    orgId: string,
+    entitySlug: string,
+    options: ListRecordsOptions = {},
+  ): PageIterator<RecordData, ListRecordsOptions> {
+    return new PageIterator((opts) => this.listPublicPage(orgId, entitySlug, opts), options)
+  }
+
+  async listPublicPage(
+    orgId: string,
+    entitySlug: string,
+    options: ListRecordsOptions = {},
+  ): Promise<ListResult<RecordData>> {
+    return this.client.requestWithQuery<ListResult<RecordData>>(
+      'GET',
+      `${PUBLIC_RECORDS_BASE_PATH}/${encodeURIComponent(orgId)}/records/${encodeURIComponent(entitySlug)}`,
+      options,
+      undefined,
+      { skipAuth: true },
+    )
+  }
+
+  async getPublic(orgId: string, entitySlug: string, id: string): Promise<RecordData> {
+    return this.client.request<RecordData>(
+      'GET',
+      `${PUBLIC_RECORDS_BASE_PATH}/${encodeURIComponent(orgId)}/records/${encodeURIComponent(entitySlug)}/${encodeURIComponent(id)}`,
+      undefined,
+      { skipAuth: true },
+    )
+  }
 }

package/src/functions/actions.ts

@@ -40,6 +40,17 @@ export interface ActionService {
    */
   invokeGlobal(slug: string, params: Record<string, unknown>): Promise<unknown>
 
+  /**
+   * Invokes a PUBLIC (`is_public`) global action without authentication — no
+   * Authorization header is sent. This is the only data path available to
+   * components on a public page. The action runs server-side as its creator
+   * (org + user injected via a machine token); non-public actions 404.
+   *
+   * @param orgId - Org id (public routes carry the org in the path — there is
+   *   no token to scope from)
+   */
+  invokePublic(orgId: string, slug: string, params: Record<string, unknown>): Promise<unknown>
+
   /**
    * Invokes an entity-scoped action against a specific record. Returns the
    * unwrapped `result` payload.
@@ -79,6 +90,20 @@ export class ActionServiceImpl implements ActionService {
     return response.result
   }
 
+  async invokePublic(
+    orgId: string,
+    slug: string,
+    params: Record<string, unknown>,
+  ): Promise<unknown> {
+    const response = await this.client.request<InvokeActionResponse>(
+      'POST',
+      `/functions/v1/public/orgs/${encodeURIComponent(orgId)}/actions/${encodeURIComponent(slug)}/invoke`,
+      params,
+      { skipAuth: true },
+    )
+    return response.result
+  }
+
   async invokeEntity(
     entitySlug: string,
     recordId: string,