@lunnoa/client 1.3.0 → 1.4.0

package/dist/index.d.cts

@@ -815,8 +815,8 @@ interface paths {
         get?: never;
         put?: never;
         /**
-         * Upsert entity type by workspace-scoped slug
-         * @description Creates or updates an entity type identified by workspace-scoped `slug`. Marks `managedByCode` by default. Prefer the CLI (`npx @lunnoa/client entity-types deploy`) over calling this from application code. Unknown instance attributes are rejected unless `allowUnknownAttributes` is true; reserved key `extensions` is always allowed.
+         * Upsert entity type by deployment-wide slug
+         * @description Creates or updates an entity type identified by deployment-wide `slug`. A new slug is granted to the caller workspace. A type already granted to other workspaces is not rewritten unless the caller is a platform admin. Marks `managedByCode` by default. Prefer the CLI (`npx @lunnoa/client entity-types deploy`). Unknown instance attributes are rejected unless `allowUnknownAttributes` is true; reserved key `extensions` is always allowed.
          */
         post: operations["ObjectTypesController_upsertBySlug"];
         delete?: never;
@@ -2408,7 +2408,7 @@ interface components {
             managedByCode?: boolean;
         };
         UpsertObjectTypeBySlugDto: {
-            /** @description Stable workspace-scoped slug (lowercase, digits, hyphens). Used as the upsert key. */
+            /** @description Stable deployment-wide slug (lowercase, digits, hyphens). Used as the upsert key. Granted to the caller workspace when new. */
             slug: string;
             /** @description Singular display name. */
             name?: string;
@@ -2471,7 +2471,7 @@ interface components {
             name: string;
             /** @description Plural display name of the entity type. */
             namePlural: string;
-            /** @description URL-safe slug, unique within the workspace. */
+            /** @description URL-safe slug, unique across the deployment. */
             slug: string;
             /** @description Icon identifier for the entity type. */
             icon: string;
@@ -6624,7 +6624,7 @@ declare function defineWorkflow(config: Omit<WorkflowDefinition, 'kind'>): Workf
 declare function defineAgent(config: Omit<AgentDefinition, 'kind'>): AgentDefinition;
 interface EntityTypeDefinition {
     kind: typeof DEFINE_KINDS.entityType;
-    /** Stable workspace-scoped slug (upsert key). */
+    /** Stable deployment-wide slug (upsert key). Granted to the deployer's workspace when new. */
     slug: string;
     name?: string;
     namePlural?: string;
@@ -6955,7 +6955,7 @@ declare class EntityTypesResource {
     private readonly http;
     constructor(http: HttpClient);
     /**
-     * Lists entity types in the workspace. Request
+     * Lists entity types granted to the API key's workspace. Request
      * `expansion: ['attributeSchema', 'stateSchema']` for the field and state
      * machine definitions the codegen CLI builds types from.
      */
@@ -6967,7 +6967,9 @@ declare class EntityTypesResource {
     /** Returns a single entity type by its URL-safe slug. */
     getBySlug(slug: string, options?: EntityTypeReadOptions): Promise<EntityType>;
     /**
-     * Creates or updates an entity type by workspace-scoped slug.
+     * Creates or updates an entity type by deployment-wide slug.
+     * A new slug is granted to the API key's workspace. A slug already shared
+     * with another workspace is rejected unless the key belongs to a platform admin.
      * Prefer the CLI (`npx @lunnoa/client entity-types deploy`) for happy-path deploy.
      */
     upsertBySlug(definition: EntityTypeDefinition | UpsertEntityTypeBySlugInput): Promise<EntityType>;

package/dist/index.d.ts

@@ -815,8 +815,8 @@ interface paths {
         get?: never;
         put?: never;
         /**
-         * Upsert entity type by workspace-scoped slug
-         * @description Creates or updates an entity type identified by workspace-scoped `slug`. Marks `managedByCode` by default. Prefer the CLI (`npx @lunnoa/client entity-types deploy`) over calling this from application code. Unknown instance attributes are rejected unless `allowUnknownAttributes` is true; reserved key `extensions` is always allowed.
+         * Upsert entity type by deployment-wide slug
+         * @description Creates or updates an entity type identified by deployment-wide `slug`. A new slug is granted to the caller workspace. A type already granted to other workspaces is not rewritten unless the caller is a platform admin. Marks `managedByCode` by default. Prefer the CLI (`npx @lunnoa/client entity-types deploy`). Unknown instance attributes are rejected unless `allowUnknownAttributes` is true; reserved key `extensions` is always allowed.
          */
         post: operations["ObjectTypesController_upsertBySlug"];
         delete?: never;
@@ -2408,7 +2408,7 @@ interface components {
             managedByCode?: boolean;
         };
         UpsertObjectTypeBySlugDto: {
-            /** @description Stable workspace-scoped slug (lowercase, digits, hyphens). Used as the upsert key. */
+            /** @description Stable deployment-wide slug (lowercase, digits, hyphens). Used as the upsert key. Granted to the caller workspace when new. */
             slug: string;
             /** @description Singular display name. */
             name?: string;
@@ -2471,7 +2471,7 @@ interface components {
             name: string;
             /** @description Plural display name of the entity type. */
             namePlural: string;
-            /** @description URL-safe slug, unique within the workspace. */
+            /** @description URL-safe slug, unique across the deployment. */
             slug: string;
             /** @description Icon identifier for the entity type. */
             icon: string;
@@ -6624,7 +6624,7 @@ declare function defineWorkflow(config: Omit<WorkflowDefinition, 'kind'>): Workf
 declare function defineAgent(config: Omit<AgentDefinition, 'kind'>): AgentDefinition;
 interface EntityTypeDefinition {
     kind: typeof DEFINE_KINDS.entityType;
-    /** Stable workspace-scoped slug (upsert key). */
+    /** Stable deployment-wide slug (upsert key). Granted to the deployer's workspace when new. */
     slug: string;
     name?: string;
     namePlural?: string;
@@ -6955,7 +6955,7 @@ declare class EntityTypesResource {
     private readonly http;
     constructor(http: HttpClient);
     /**
-     * Lists entity types in the workspace. Request
+     * Lists entity types granted to the API key's workspace. Request
      * `expansion: ['attributeSchema', 'stateSchema']` for the field and state
      * machine definitions the codegen CLI builds types from.
      */
@@ -6967,7 +6967,9 @@ declare class EntityTypesResource {
     /** Returns a single entity type by its URL-safe slug. */
     getBySlug(slug: string, options?: EntityTypeReadOptions): Promise<EntityType>;
     /**
-     * Creates or updates an entity type by workspace-scoped slug.
+     * Creates or updates an entity type by deployment-wide slug.
+     * A new slug is granted to the API key's workspace. A slug already shared
+     * with another workspace is rejected unless the key belongs to a platform admin.
      * Prefer the CLI (`npx @lunnoa/client entity-types deploy`) for happy-path deploy.
      */
     upsertBySlug(definition: EntityTypeDefinition | UpsertEntityTypeBySlugInput): Promise<EntityType>;

package/dist/index.js

@@ -1082,7 +1082,7 @@ var EntityTypesResource = class {
   }
   http;
   /**
-   * Lists entity types in the workspace. Request
+   * Lists entity types granted to the API key's workspace. Request
    * `expansion: ['attributeSchema', 'stateSchema']` for the field and state
    * machine definitions the codegen CLI builds types from.
    */
@@ -1107,7 +1107,9 @@ var EntityTypesResource = class {
     });
   }
   /**
-   * Creates or updates an entity type by workspace-scoped slug.
+   * Creates or updates an entity type by deployment-wide slug.
+   * A new slug is granted to the API key's workspace. A slug already shared
+   * with another workspace is rejected unless the key belongs to a platform admin.
    * Prefer the CLI (`npx @lunnoa/client entity-types deploy`) for happy-path deploy.
    */
   upsertBySlug(definition) {