@cosmicdrift/kumiko-types 0.159.1 → 0.161.0

package/src/rate-limit-types.ts

@@ -0,0 +1,30 @@
+export type RateLimitDecision = {
+  readonly allowed: boolean;
+  readonly limit: number;
+  readonly remaining: number;
+  readonly retryAfterSeconds: number;
+  readonly windowSeconds: number;
+  readonly resetAt: Temporal.Instant;
+};
+
+export type RateLimitConfig = {
+  readonly limit: number;
+  readonly windowSeconds: number;
+  readonly cost?: number;
+};
+
+export type RateLimitResolver = {
+  // Atomic check + deduct. Returns the decision and current bucket state
+  // — caller decides whether to throw RateLimitError or proceed.
+  check(bucket: string, config: RateLimitConfig): Promise<RateLimitDecision>;
+
+  // Convenience: throws RateLimitError when blocked. Useful inside the
+  // dispatcher / middleware code-paths where the failure shape is fixed.
+  enforce(bucket: string, config: RateLimitConfig): Promise<RateLimitDecision>;
+
+  // Read-only inspection: returns the same shape as check() but never
+  // mutates the bucket — no token deduction, no refill-timestamp update.
+  // Use for ops/status queries (e.g. "kumiko rl status user:42") that
+  // must observe the bucket without disturbing it.
+  peek(bucket: string, config: Omit<RateLimitConfig, "cost">): Promise<RateLimitDecision>;
+};

package/src/schema-table-types.ts

@@ -0,0 +1,24 @@
+import type { EntityTableMeta, PgType } from "./entity-table-meta-types";
+
+// Global-registry symbols the native dialect stamps onto every SchemaTable —
+// shared identity so downstream introspection (Symbol.for lookups) matches
+// exactly the same unique-symbol type as the one used to construct the table.
+export const KUMIKO_NAME_SYMBOL = Symbol.for("kumiko:schema:Name");
+export const KUMIKO_COLUMNS_SYMBOL = Symbol.for("kumiko:schema:Columns");
+
+// Column handle exposed on the SchemaTable. The `name` is the SQL column
+// name (snake_case); legacy code accesses `table.fieldName.name` to
+// produce raw SQL.
+export type ColumnHandle = {
+  readonly name: string;
+  readonly pgType: PgType;
+  readonly getSQLType: () => string;
+};
+
+// SchemaTable — opaque shape with both EntityTableMeta + Symbol-based
+// introspection. Returned by `table(...)`.
+export type SchemaTable = EntityTableMeta & {
+  readonly [KUMIKO_NAME_SYMBOL]: string;
+  readonly [KUMIKO_COLUMNS_SYMBOL]: Record<string, ColumnHandle>;
+  readonly [field: string]: unknown;
+};