@cosmicdrift/kumiko-types 0.338.0 → 0.340.0

package/dist/aggregate-types.d.ts

@@ -16,6 +16,8 @@ export type AggregateSpec = {
     readonly measure: AggregateMeasure;
     readonly groupBy?: readonly AggregateDimension[];
     readonly orderByValue?: "asc" | "desc";
+    /** Direction of the group-key ordering (default asc). orderByValue stays the primary key when set. */
+    readonly orderByKeys?: "asc" | "desc";
     readonly limit?: number;
 };
 export type AggregateKey = string | number | boolean | null;

package/dist/define-handler.d.ts

@@ -12,6 +12,7 @@ export type WriteHandlerDefinition<TName extends string = string, TSchema extend
     readonly unsafeSkipTransitionGuard?: boolean;
     readonly rateLimit?: RateLimitDeclaration;
     readonly escapeHatch?: EscapeHatchDeclaration;
+    readonly tenantlessAnonymous?: boolean;
     readonly handler: (event: WriteEvent<z.infer<TSchema>>, context: HandlerContext<TMap>) => Promise<WriteResult<TData>>;
     readonly perform?: PipelineDef<z.infer<TSchema>, TData>;
 };
@@ -24,6 +25,7 @@ export type WriteHandlerInput<TName extends string = string, TSchema extends Zod
     readonly unsafeSkipTransitionGuard?: boolean;
     readonly rateLimit?: RateLimitDeclaration;
     readonly escapeHatch?: EscapeHatchDeclaration;
+    readonly tenantlessAnonymous?: boolean;
 } & ({
     readonly handler: (event: WriteEvent<z.infer<TSchema>>, context: HandlerContext<TMap>) => Promise<WriteResult<TData>>;
     readonly perform?: never;

package/dist/handlers.d.ts

@@ -473,6 +473,10 @@ export type WriteHandlerDef = {
     readonly unsafeSkipTransitionGuard?: boolean;
     readonly rateLimit?: RateLimitDeclaration;
     readonly escapeHatch?: EscapeHatchDeclaration;
+    /** Lets an anonymous `POST /api/write` for this handler proceed under
+     *  SYSTEM_TENANT_ID when the host resolves no tenant. Boot requires
+     *  `access.roles: ["anonymous"]` and a real `rateLimit`. */
+    readonly tenantlessAnonymous?: boolean;
     readonly perform?: import("./step.js").PipelineDef;
 };
 export declare const ENTITY_CONVENTION_QUERY_BRAND = "__kumikoEntityConventionQuery";

package/dist/step.js

@@ -1,4 +1,4 @@
-// Step-Vocabulary Types — see docs/plans/architecture/intern/step-vocabulary.md
+// Step-Vocabulary Types — see kumiko-platform/docs/archive/plans/architecture/intern/step-vocabulary.md
 //
 // M.1 minimal scope:
 //   - Steps execute against the existing HandlerContext (no per-step subset).

package/dist/tenant-db-types.d.ts

@@ -34,9 +34,9 @@ export type TenantDb = {
     readonly mode: TenantDbMode;
     /**
      * Unfiltered DbRunner escape hatch for handlers/hooks that declare `escapeHatch: { reason }`.
-     * Throws `AccessDeniedError` when ungranted, or `Error` when `reason` is empty.
+     * Throws `AccessDeniedError` when ungranted. The audit entry carries the declared escapeHatch reason.
      */
-    unsafeRaw(reason: string): DbRunner;
+    unsafeRaw(): DbRunner;
     /**
      * Reach a "global" table with the tenant filter lifted — reads always work; writes
      * reject unless the write handler declared `escapeHatch: { reason }`. "tenant"-tenancy is a compile error here.

package/dist/where-clause-types.d.ts

@@ -1,3 +1,8 @@
+export type JsonTextMatch = {
+    /** Top-level keys, tried in order; the first non-null text value is compared (COALESCE). */
+    readonly keys: readonly [string, ...string[]];
+    readonly eq: string;
+};
 export type WhereOperator = {
     readonly gt?: unknown;
     readonly gte?: unknown;
@@ -6,6 +11,8 @@ export type WhereOperator = {
     readonly ne?: unknown;
     readonly in?: readonly unknown[];
     readonly like?: string;
+    /** jsonb columns only; cannot be combined with other operators in the same object. */
+    readonly jsonText?: JsonTextMatch | readonly JsonTextMatch[];
 };
 export type WherePrimitive = string | number | boolean | bigint | Date | null | undefined;
 export type WhereValue = WherePrimitive | readonly WherePrimitive[] | WhereOperator;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.338.0",
+  "version": "0.340.0",
   "description": "Framework-Type-Definitions für Kumiko — FeatureDefinition, BootCheck-Types und die reinen Engine-Types. Erlaubt Downstream-Konsumenten, gegen die Type-Contracts zu bauen, ohne das ganze Framework-Package zu importieren. Enthaelt keine identitaets-sensitiven Runtime-Werte mehr (Error-Klassen leben seit #1629 in kumiko-framework, Brand-Symbole nutzen Symbol.for) und ist deshalb eine plain dependency, keine peerDependency.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",

package/src/changes.json

@@ -1,4 +1,11 @@
 [
+  {
+    "version": "0.340.0",
+    "type": "improvement",
+    "title": "Where clauses and aggregate options describe jsonb text matches and key ordering",
+    "detail": "`WhereOperator` gains `jsonText?: JsonTextMatch | readonly JsonTextMatch[]` with `JsonTextMatch = { keys: readonly [string, ...string[]]; eq: string }`, and the aggregate options gain `orderByKeys?: \"asc\" | \"desc\"`.",
+    "migration": "keine"
+  },
   {
     "version": "0.338.0",
     "type": "improvement",