@stigmer/react 3.2.2 → 3.3.0

package/datastore/recordValues.js

@@ -0,0 +1,282 @@
+// Canonical value semantics of declared datastore fields, at the UI
+// boundary.
+//
+// The authoritative implementation lives in the record layer (OSS
+// `pkg/domain/datastore/schema` + `records/filter.go`, mirrored
+// byte-identically in the cloud Java service — the DD-004 cross-edition
+// contract). This module is a client-side PROJECTION of that contract:
+// it lets forms fail fast with friendly messages and lets the filter
+// builder offer only servable operators. The server remains the
+// enforcer — a stale or buggy projection degrades to a clean server
+// denial, never a false allow (DD-008 invariant 3).
+//
+// Canonical encodings (DD-004):
+//   - string:    the string itself (enum_values membership checked)
+//   - integer:   integral JSON number
+//   - number:    JSON number
+//   - bool:      JSON boolean
+//   - timestamp: RFC 3339 UTC, e.g. "2026-07-21T04:30:00Z"
+//   - date:      "YYYY-MM-DD" (lexicographically chronological)
+//   - time:      "HH:MM:SS" zero-padded ("HH:MM" input canonicalized)
+//   - json:      any JSON value, stored as-is
+//
+// google.protobuf.Struct fields are plain `JsonObject` values in
+// protobuf-es v2, so record payloads need no proto conversion — the
+// entire client-side value story is validation + canonicalization of
+// these JSON shapes.
+import { FieldType, } from "@stigmer/protos/ai/stigmer/agentic/datastore/v1/spec_pb";
+import { RecordConditionOp } from "@stigmer/protos/ai/stigmer/agentic/datastore/v1/record_io_pb";
+/**
+ * Record-envelope system field names (plus the cloud tenancy column and
+ * the DD-010 partition label). Never declarable, never caller-writable.
+ */
+export const RESERVED_FIELD_NAMES = new Set([
+    "id",
+    "created_at",
+    "updated_at",
+    "created_by",
+    "org",
+    "partition",
+]);
+const ok = (value) => ({ ok: true, value });
+const fail = (error) => ({ ok: false, error });
+// Zero-padded HH:MM or HH:MM:SS with valid ranges (mirrors the Go
+// canonicalizeTime, which rejects unpadded input).
+const TIME_RE = /^([01]\d|2[0-3]):([0-5]\d)(:([0-5]\d))?$/;
+const DATE_RE = /^(\d{4})-(\d{2})-(\d{2})$/;
+// RFC 3339 date-time: requires the "T" separator and an explicit UTC
+// "Z" or numeric offset — the same shape Go's time.RFC3339Nano accepts.
+const TIMESTAMP_RE = /^\d{4}-\d{2}-\d{2}[Tt]\d{2}:\d{2}:\d{2}(\.\d+)?([Zz]|[+-]\d{2}:\d{2})$/;
+/**
+ * Validate a caller-supplied field value against its declaration and
+ * return the canonical JSON encoding (see module doc). `null` means
+ * explicit null — valid here for any field; required-ness is write-path
+ * policy (updates only see the supplied subset), exactly as in the
+ * server's CanonicalizeValue.
+ *
+ * Error messages match the server's shape (`field "x" must be …`) so a
+ * client-side rejection reads the same as the server rejection it
+ * pre-empts.
+ */
+export function coerceFieldValue(field, value) {
+    if (value === null)
+        return ok(null);
+    const name = field.name;
+    switch (field.type) {
+        case FieldType.string: {
+            if (typeof value !== "string")
+                return fail(`field "${name}" must be a string`);
+            const enums = field.enumValues;
+            if (enums.length > 0 && !enums.includes(value)) {
+                return fail(`field "${name}" must be one of [${enums.join(" ")}]`);
+            }
+            return ok(value);
+        }
+        case FieldType.integer: {
+            if (typeof value !== "number" || !Number.isInteger(value)) {
+                return fail(`field "${name}" must be an integer`);
+            }
+            // int64 on the server; reject values JS cannot carry exactly
+            // rather than silently submitting a rounded number.
+            if (!Number.isSafeInteger(value)) {
+                return fail(`field "${name}" is too large to represent exactly`);
+            }
+            return ok(value);
+        }
+        case FieldType.number: {
+            if (typeof value !== "number" || !Number.isFinite(value)) {
+                return fail(`field "${name}" must be a number`);
+            }
+            return ok(value);
+        }
+        case FieldType.bool: {
+            if (typeof value !== "boolean")
+                return fail(`field "${name}" must be a boolean`);
+            return ok(value);
+        }
+        case FieldType.timestamp: {
+            if (typeof value !== "string" || !TIMESTAMP_RE.test(value) || Number.isNaN(Date.parse(value))) {
+                return fail(`field "${name}" must be an RFC 3339 timestamp (e.g. 2026-07-21T04:30:00Z)`);
+            }
+            // The server canonicalizes to UTC on write; submitting the parsed
+            // RFC 3339 value as-is (offset included) is valid input.
+            return ok(value);
+        }
+        case FieldType.date: {
+            if (typeof value !== "string" || !isValidCalendarDate(value)) {
+                return fail(`field "${name}" must be a valid YYYY-MM-DD date`);
+            }
+            return ok(value);
+        }
+        case FieldType.time: {
+            if (typeof value !== "string") {
+                return fail(`field "${name}" must be an HH:MM[:SS] time string`);
+            }
+            const m = TIME_RE.exec(value);
+            if (!m) {
+                return fail(`field "${name}" must be a valid zero-padded HH:MM[:SS] time`);
+            }
+            // Canonicalize HH:MM → HH:MM:SS so values compare lexicographically.
+            return ok(m[3] === undefined ? `${value}:00` : value);
+        }
+        case FieldType.json:
+            return ok(value);
+        default:
+            return fail(`field "${name}" has an unsupported type`);
+    }
+}
+/** Whether a YYYY-MM-DD string names a real calendar date (rejects 2026-02-30). */
+function isValidCalendarDate(s) {
+    const m = DATE_RE.exec(s);
+    if (!m)
+        return false;
+    const [, y, mo, d] = m;
+    const date = new Date(Date.UTC(Number(y), Number(mo) - 1, Number(d)));
+    return (date.getUTCFullYear() === Number(y) &&
+        date.getUTCMonth() === Number(mo) - 1 &&
+        date.getUTCDate() === Number(d));
+}
+/**
+ * Format a canonical field value for grid-cell display. Values render
+ * in their DD-004 canonical encodings (honest, timezone-free); the one
+ * concession to readability is trimming a timestamp's zero fractional
+ * seconds (storage pads to nine digits for lexicographic ordering —
+ * "…T04:30:00.000000000Z" and "…T04:30:00Z" are the same RFC 3339 UTC
+ * instant).
+ */
+export function formatFieldValue(type, value) {
+    if (value === null || value === undefined)
+        return "";
+    switch (type) {
+        case FieldType.timestamp:
+            return typeof value === "string" ? trimZeroFraction(value) : String(value);
+        case FieldType.json:
+            return JSON.stringify(value);
+        case FieldType.bool:
+            return value === true ? "true" : "false";
+        default:
+            return String(value);
+    }
+}
+/** Also used for the envelope's created_at/updated_at system columns. */
+export function formatSystemTimestamp(value) {
+    return trimZeroFraction(value);
+}
+function trimZeroFraction(ts) {
+    return ts.replace(/\.0+Z$/, "Z");
+}
+/**
+ * The per-type operator matrix (record_io.proto @internal, DD-005 SD-2)
+ * — a projection of the server's opsForFieldType. The filter builder
+ * offers exactly these, making an unservable operator structurally
+ * unofferable (DD-008 invariant 2):
+ *
+ *   string (incl. enum):   eq, neq, is_in, not_in
+ *   bool:                  eq, neq
+ *   integer, number,
+ *   timestamp, date, time: eq, neq, gt, gte, lt, lte
+ *   json:                  not filterable
+ *   + is_null / not_null on any optional (non-required) field
+ */
+export function operatorsForField(field) {
+    const base = baseOperatorsForType(field.type);
+    if (base.length === 0)
+        return [];
+    return field.required
+        ? base
+        : [...base, RecordConditionOp.is_null, RecordConditionOp.not_null];
+}
+function baseOperatorsForType(type) {
+    switch (type) {
+        case FieldType.string:
+            return [
+                RecordConditionOp.eq,
+                RecordConditionOp.neq,
+                RecordConditionOp.is_in,
+                RecordConditionOp.not_in,
+            ];
+        case FieldType.bool:
+            return [RecordConditionOp.eq, RecordConditionOp.neq];
+        case FieldType.integer:
+        case FieldType.number:
+        case FieldType.timestamp:
+        case FieldType.date:
+        case FieldType.time:
+            return [
+                RecordConditionOp.eq,
+                RecordConditionOp.neq,
+                RecordConditionOp.gt,
+                RecordConditionOp.gte,
+                RecordConditionOp.lt,
+                RecordConditionOp.lte,
+            ];
+        default:
+            // json (and unspecified) are not filterable.
+            return [];
+    }
+}
+/**
+ * The filterable system fields and their operator sets (mirrors the
+ * server's buildSystemCondition): `id` by identity, the audit
+ * timestamps by range. `created_by`, `org`, and `partition` are not
+ * filterable — attribution is the grant system's privacy boundary and
+ * partition is ambient scope, never data.
+ */
+export const SYSTEM_FIELD_OPERATORS = new Map([
+    ["id", [RecordConditionOp.eq, RecordConditionOp.is_in]],
+    [
+        "created_at",
+        [RecordConditionOp.gt, RecordConditionOp.gte, RecordConditionOp.lt, RecordConditionOp.lte],
+    ],
+    [
+        "updated_at",
+        [RecordConditionOp.gt, RecordConditionOp.gte, RecordConditionOp.lt, RecordConditionOp.lte],
+    ],
+]);
+/** Operators that take no value (null tests). */
+export function isValuelessOperator(op) {
+    return op === RecordConditionOp.is_null || op === RecordConditionOp.not_null;
+}
+/** Operators that take a value list (`values`) rather than a scalar. */
+export function isListOperator(op) {
+    return op === RecordConditionOp.is_in || op === RecordConditionOp.not_in;
+}
+/**
+ * Human labels for the filter builder and chips. `is_in` is displayed
+ * as "in" — the proto spelling exists only because `in` is reserved in
+ * Java/Python, a substrate detail operators never see.
+ */
+export const OPERATOR_LABELS = new Map([
+    [RecordConditionOp.eq, "="],
+    [RecordConditionOp.neq, "≠"],
+    [RecordConditionOp.gt, ">"],
+    [RecordConditionOp.gte, "≥"],
+    [RecordConditionOp.lt, "<"],
+    [RecordConditionOp.lte, "≤"],
+    [RecordConditionOp.is_in, "in"],
+    [RecordConditionOp.not_in, "not in"],
+    [RecordConditionOp.is_null, "is empty"],
+    [RecordConditionOp.not_null, "is not empty"],
+]);
+/**
+ * Sortable fields: any declared non-json field, plus the system id and
+ * audit timestamps (mirrors the server's BuildOrderBy).
+ */
+export function isSortableField(field) {
+    return field.type !== FieldType.json && field.type !== FieldType.field_type_unspecified;
+}
+/**
+ * Build an update payload from per-field edits (DD-005 partial merge).
+ * The RPC's tri-state: a key present with a value replaces the field, a
+ * key present with `null` explicitly clears it, an absent key leaves
+ * the stored value untouched. Callers pass only the dirty fields —
+ * cleared ones as `null`.
+ */
+export function buildUpdateFields(edits) {
+    const out = {};
+    for (const [name, value] of edits) {
+        out[name] = value;
+    }
+    return out;
+}
+//# sourceMappingURL=recordValues.js.map

package/datastore/recordValues.js.map

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

package/datastore/useDatastore.d.ts

@@ -0,0 +1,39 @@
+import type { Datastore } from "@stigmer/protos/ai/stigmer/agentic/datastore/v1/api_pb";
+/** Return value of {@link useDatastore}. */
+export interface UseDatastoreReturn {
+    /** The resolved datastore, or `null` while loading, on error, or when not found. */
+    readonly datastore: Datastore | null;
+    /** `true` while the initial fetch is in flight. */
+    readonly isLoading: boolean;
+    /** `true` while a background refetch is in flight. */
+    readonly isRefetching: boolean;
+    /** Error from the last failed request, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Discard cached data and re-fetch the datastore from the server. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches a single Datastore by organization and slug.
+ *
+ * Wraps `stigmer.datastore.getByReference()` with loading, error, and
+ * not-found state management. The loaded resource carries the spec
+ * (collections, fields, constraints, authorization) and status (sync
+ * report, per-collection record counts) — the authoritative source for
+ * every structural view (DD-008 SD-5: spec for structure, status for
+ * health; `describeDatastore` is consulted only for caller-effective
+ * verbs — see {@link useDatastoreDescription}).
+ *
+ * Pass `null` for either `org` or `slug` to skip fetching (stable
+ * no-op).
+ *
+ * **Not-found handling:** a NOT_FOUND response sets `datastore` to
+ * `null` without raising an error; `datastore === null && !isLoading
+ * && !error` means the resource does not exist.
+ *
+ * @example
+ * ```tsx
+ * const { datastore, isLoading, error } = useDatastore("acme", "clinic");
+ * ```
+ */
+export declare function useDatastore(org: string | null, slug: string | null): UseDatastoreReturn;
+//# sourceMappingURL=useDatastore.d.ts.map

package/datastore/useDatastore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDatastore.d.ts","sourceRoot":"","sources":["../../src/datastore/useDatastore.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wDAAwD,CAAC;AAKxF,4CAA4C;AAC5C,MAAM,WAAW,kBAAkB;IACjC,oFAAoF;IACpF,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IACrC,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,IAAI,EAAE,MAAM,GAAG,IAAI,GAClB,kBAAkB,CAmBpB"}

package/datastore/useDatastore.js

@@ -0,0 +1,44 @@
+"use client";
+import { isNotFound } from "@stigmer/sdk";
+import { useStigmer } from "../hooks.js";
+import { useFetch } from "../internal/useFetch.js";
+/**
+ * Data hook that fetches a single Datastore by organization and slug.
+ *
+ * Wraps `stigmer.datastore.getByReference()` with loading, error, and
+ * not-found state management. The loaded resource carries the spec
+ * (collections, fields, constraints, authorization) and status (sync
+ * report, per-collection record counts) — the authoritative source for
+ * every structural view (DD-008 SD-5: spec for structure, status for
+ * health; `describeDatastore` is consulted only for caller-effective
+ * verbs — see {@link useDatastoreDescription}).
+ *
+ * Pass `null` for either `org` or `slug` to skip fetching (stable
+ * no-op).
+ *
+ * **Not-found handling:** a NOT_FOUND response sets `datastore` to
+ * `null` without raising an error; `datastore === null && !isLoading
+ * && !error` means the resource does not exist.
+ *
+ * @example
+ * ```tsx
+ * const { datastore, isLoading, error } = useDatastore("acme", "clinic");
+ * ```
+ */
+export function useDatastore(org, slug) {
+    const stigmer = useStigmer();
+    const { data: datastore, isLoading, isRefetching, error, refetch } = useFetch(org && slug
+        ? async () => {
+            try {
+                return await stigmer.datastore.getByReference({ org, slug });
+            }
+            catch (err) {
+                if (isNotFound(err))
+                    return null;
+                throw err;
+            }
+        }
+        : null, [org, slug, stigmer], null);
+    return { datastore, isLoading, isRefetching, error, refetch };
+}
+//# sourceMappingURL=useDatastore.js.map

package/datastore/useDatastore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDatastore.js","sourceRoot":"","sources":["../../src/datastore/useDatastore.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAGb,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAgBnD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,YAAY,CAC1B,GAAkB,EAClB,IAAmB;IAEnB,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,CAC3E,GAAG,IAAI,IAAI;QACT,CAAC,CAAC,KAAK,IAAI,EAAE;YACT,IAAI,CAAC;gBACH,OAAO,MAAM,OAAO,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/D,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,UAAU,CAAC,GAAG,CAAC;oBAAE,OAAO,IAAI,CAAC;gBACjC,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;QACH,CAAC,CAAC,IAAI,EACR,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,EACpB,IAAI,CACL,CAAC;IAEF,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAChE,CAAC"}

package/datastore/useDatastoreCount.d.ts

@@ -0,0 +1,48 @@
+import { type ResourceListScope } from "../search/index.js";
+/** Options for {@link useDatastoreCount}. */
+export interface UseDatastoreCountOptions {
+    /** Text query to filter datastores before counting. */
+    readonly query?: string;
+    /**
+     * Controls which datastores are counted.
+     *
+     * - `"org"` — only datastores owned by the given organization.
+     * - `"all"` — includes public/platform datastores.
+     *
+     * @default "org"
+     */
+    readonly scope?: ResourceListScope;
+}
+/** Return value of {@link useDatastoreCount}. */
+export interface UseDatastoreCountReturn {
+    /**
+     * Total number of datastores matching the current filters. `undefined`
+     * until the first successful fetch completes.
+     */
+    readonly count: number | undefined;
+    /** `true` while the count fetch is in flight. */
+    readonly isLoading: boolean;
+    /** Error from the last failed request, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Discard cached data and re-fetch the count from the server. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches the total count of datastores.
+ *
+ * Issues a minimal `stigmer.datastore.list()` call to retrieve only the
+ * total count — no datastore entries are returned or stored. Useful for
+ * the Library landing card and dashboard widgets.
+ *
+ * For the full paginated datastore list, use {@link useDatastoreList}
+ * instead.
+ *
+ * Pass `null` as `org` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { count, isLoading } = useDatastoreCount("acme");
+ * ```
+ */
+export declare function useDatastoreCount(org: string | null, options?: UseDatastoreCountOptions): UseDatastoreCountReturn;
+//# sourceMappingURL=useDatastoreCount.d.ts.map

package/datastore/useDatastoreCount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDatastoreCount.d.ts","sourceRoot":"","sources":["../../src/datastore/useDatastoreCount.ts"],"names":[],"mappings":"AAIA,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE9E,6CAA6C;AAC7C,MAAM,WAAW,wBAAwB;IACvC,uDAAuD;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;CACpC;AAED,iDAAiD;AACjD,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,OAAO,CAAC,EAAE,wBAAwB,GACjC,uBAAuB,CAUzB"}

package/datastore/useDatastoreCount.js

@@ -0,0 +1,27 @@
+"use client";
+import { useCallback } from "react";
+import { useStigmer } from "../hooks.js";
+import { useResourceCount } from "../search/index.js";
+/**
+ * Data hook that fetches the total count of datastores.
+ *
+ * Issues a minimal `stigmer.datastore.list()` call to retrieve only the
+ * total count — no datastore entries are returned or stored. Useful for
+ * the Library landing card and dashboard widgets.
+ *
+ * For the full paginated datastore list, use {@link useDatastoreList}
+ * instead.
+ *
+ * Pass `null` as `org` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { count, isLoading } = useDatastoreCount("acme");
+ * ```
+ */
+export function useDatastoreCount(org, options) {
+    const stigmer = useStigmer();
+    const listFn = useCallback((params) => stigmer.datastore.list(params), [stigmer]);
+    return useResourceCount(listFn, org, options);
+}
+//# sourceMappingURL=useDatastoreCount.js.map

package/datastore/useDatastoreCount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDatastoreCount.js","sourceRoot":"","sources":["../../src/datastore/useDatastoreCount.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAA0B,MAAM,oBAAoB,CAAC;AAgC9E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAkB,EAClB,OAAkC;IAElC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,MAAM,MAAM,GAAG,WAAW,CACxB,CAAC,MAAoD,EAAE,EAAE,CACvD,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAChC,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC"}

package/datastore/useDatastoreDescription.d.ts

@@ -0,0 +1,54 @@
+import { type DatastoreDescription } from "@stigmer/protos/ai/stigmer/agentic/datastore/v1/record_io_pb";
+/** The partition every datastore starts with (DD-010). */
+export declare const DEFAULT_PARTITION = "default";
+/** Return value of {@link useDatastoreDescription}. */
+export interface UseDatastoreDescriptionReturn {
+    /** The caller-effective description, or `null` while loading or on error. */
+    readonly description: DatastoreDescription | null;
+    /**
+     * Selectable data partitions: the datastore's partition catalog with
+     * `"default"` always present. The catalog materializes with the first
+     * record write, so on an empty datastore it reports nothing — but the
+     * default partition is always addressable (DD-010: unset partition
+     * means `"default"`), so the picker must always offer it.
+     */
+    readonly partitions: readonly string[];
+    /** `true` while the initial fetch is in flight. */
+    readonly isLoading: boolean;
+    /** `true` while a background refetch is in flight. */
+    readonly isRefetching: boolean;
+    /** Error from the last failed request, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Discard cached data and re-fetch the description from the server. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches the caller-effective view of a datastore via
+ * `describeDatastore`.
+ *
+ * This is the console's **only** source of caller-effective record
+ * verbs (DD-008 SD-2): record grants are datastore domain logic, not
+ * FGA, so resource-layer permission checks structurally cannot answer
+ * "may I insert into bookings?". Every record write affordance gates on
+ * the per-collection `access` lists returned here — and those lists are
+ * projections, never authority: the server's record layer remains the
+ * enforcer, so a stale projection degrades to a clean denial.
+ *
+ * **Denied-state semantics** (DD-008 SD-3): a caller with resource
+ * visibility but no record grants gets a successful response with
+ * empty `access` lists — deny-by-default renders as empty access,
+ * never an error. A reach-level `PERMISSION_DENIED` (no
+ * `can_use_records` in cloud) surfaces as `error`; consumers render
+ * both as the Records-tab denied panel, not a page-level failure.
+ *
+ * Pass `null` for `org` or `datastore` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { description, partitions } = useDatastoreDescription("acme", "clinic");
+ * const bookings = description?.collections.find((c) => c.name === "bookings");
+ * const canInsert = bookings?.access.some((a) => a.verb === DatastoreVerb.insert);
+ * ```
+ */
+export declare function useDatastoreDescription(org: string | null, datastore: string | null): UseDatastoreDescriptionReturn;
+//# sourceMappingURL=useDatastoreDescription.d.ts.map

package/datastore/useDatastoreDescription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDatastoreDescription.d.ts","sourceRoot":"","sources":["../../src/datastore/useDatastoreDescription.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,8DAA8D,CAAC;AAItE,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAE3C,uDAAuD;AACvD,MAAM,WAAW,6BAA6B;IAC5C,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAClD;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,6BAA6B,CAsB/B"}

package/datastore/useDatastoreDescription.js

@@ -0,0 +1,50 @@
+"use client";
+import { useMemo } from "react";
+import { create } from "@bufbuild/protobuf";
+import { DescribeDatastoreRequestSchema, } from "@stigmer/protos/ai/stigmer/agentic/datastore/v1/record_io_pb";
+import { useStigmer } from "../hooks.js";
+import { useFetch } from "../internal/useFetch.js";
+/** The partition every datastore starts with (DD-010). */
+export const DEFAULT_PARTITION = "default";
+/**
+ * Data hook that fetches the caller-effective view of a datastore via
+ * `describeDatastore`.
+ *
+ * This is the console's **only** source of caller-effective record
+ * verbs (DD-008 SD-2): record grants are datastore domain logic, not
+ * FGA, so resource-layer permission checks structurally cannot answer
+ * "may I insert into bookings?". Every record write affordance gates on
+ * the per-collection `access` lists returned here — and those lists are
+ * projections, never authority: the server's record layer remains the
+ * enforcer, so a stale projection degrades to a clean denial.
+ *
+ * **Denied-state semantics** (DD-008 SD-3): a caller with resource
+ * visibility but no record grants gets a successful response with
+ * empty `access` lists — deny-by-default renders as empty access,
+ * never an error. A reach-level `PERMISSION_DENIED` (no
+ * `can_use_records` in cloud) surfaces as `error`; consumers render
+ * both as the Records-tab denied panel, not a page-level failure.
+ *
+ * Pass `null` for `org` or `datastore` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { description, partitions } = useDatastoreDescription("acme", "clinic");
+ * const bookings = description?.collections.find((c) => c.name === "bookings");
+ * const canInsert = bookings?.access.some((a) => a.verb === DatastoreVerb.insert);
+ * ```
+ */
+export function useDatastoreDescription(org, datastore) {
+    const stigmer = useStigmer();
+    const { data: description, isLoading, isRefetching, error, refetch } = useFetch(org && datastore
+        ? () => stigmer.datastore.describeDatastore(create(DescribeDatastoreRequestSchema, { org, datastore }))
+        : null, [org, datastore, stigmer], null);
+    const partitions = useMemo(() => {
+        const catalog = description?.partitions ?? [];
+        return catalog.includes(DEFAULT_PARTITION)
+            ? catalog
+            : [DEFAULT_PARTITION, ...catalog];
+    }, [description]);
+    return { description, partitions, isLoading, isRefetching, error, refetch };
+}
+//# sourceMappingURL=useDatastoreDescription.js.map

package/datastore/useDatastoreDescription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDatastoreDescription.js","sourceRoot":"","sources":["../../src/datastore/useDatastoreDescription.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EACL,8BAA8B,GAE/B,MAAM,8DAA8D,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD,0DAA0D;AAC1D,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAwB3C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,uBAAuB,CACrC,GAAkB,EAClB,SAAwB;IAExB,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,CAC7E,GAAG,IAAI,SAAS;QACd,CAAC,CAAC,GAAG,EAAE,CACH,OAAO,CAAC,SAAS,CAAC,iBAAiB,CACjC,MAAM,CAAC,8BAA8B,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAC3D;QACL,CAAC,CAAC,IAAI,EACR,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,EACzB,IAAI,CACL,CAAC;IAEF,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE;QAC9B,MAAM,OAAO,GAAG,WAAW,EAAE,UAAU,IAAI,EAAE,CAAC;QAC9C,OAAO,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC;YACxC,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,CAAC,iBAAiB,EAAE,GAAG,OAAO,CAAC,CAAC;IACtC,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;IAElB,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC9E,CAAC"}

package/datastore/useDatastoreList.d.ts

@@ -0,0 +1,57 @@
+import type { SearchResult } from "@stigmer/protos/ai/stigmer/search/v1/io_pb";
+import { type ResourceListScope } from "../search/index.js";
+/** Options for {@link useDatastoreList}. */
+export interface UseDatastoreListOptions {
+    /** Maximum datastores per page. @default 20 */
+    readonly pageSize?: number;
+    /** Page number (1-indexed). @default 1 */
+    readonly page?: number;
+    /** Text query to filter datastores by name, description, or tags. */
+    readonly query?: string;
+    /**
+     * Controls which datastores are visible.
+     *
+     * - `"org"` — only datastores owned by the given organization.
+     * - `"all"` — includes public/platform datastores.
+     *
+     * @default "org"
+     */
+    readonly scope?: ResourceListScope;
+}
+/** Return value of {@link useDatastoreList}. */
+export interface UseDatastoreListReturn {
+    /** Paginated datastore entries for the current page. */
+    readonly datastores: readonly SearchResult[];
+    /** Total number of datastores matching the current filters. */
+    readonly totalCount: number;
+    /** Total pages available at the current page size. */
+    readonly totalPages: number;
+    /** The current page number (mirrors the `page` option). */
+    readonly currentPage: number;
+    /** `true` while the initial fetch or a refetch is in flight. */
+    readonly isLoading: boolean;
+    /** Error from the last failed request, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Discard cached data and re-fetch the current page from the server. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches a paginated list of datastores for the Library.
+ *
+ * Wraps `stigmer.datastore.list()` (SearchService-backed) with
+ * pagination, scope filtering, and text search. All parameters are
+ * externally controlled — the consumer manages page state, query
+ * debouncing, and scope toggling.
+ *
+ * Pass `null` as `org` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { datastores, totalCount, isLoading } = useDatastoreList("acme", {
+ *   page: 1,
+ *   pageSize: 20,
+ * });
+ * ```
+ */
+export declare function useDatastoreList(org: string | null, options?: UseDatastoreListOptions): UseDatastoreListReturn;
+//# sourceMappingURL=useDatastoreList.d.ts.map

package/datastore/useDatastoreList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDatastoreList.d.ts","sourceRoot":"","sources":["../../src/datastore/useDatastoreList.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAE/E,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE7E,4CAA4C;AAC5C,MAAM,WAAW,uBAAuB;IACtC,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;CACpC;AAED,gDAAgD;AAChD,MAAM,WAAW,sBAAsB;IACrC,wDAAwD;IACxD,QAAQ,CAAC,UAAU,EAAE,SAAS,YAAY,EAAE,CAAC;IAC7C,+DAA+D;IAC/D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,OAAO,CAAC,EAAE,uBAAuB,GAChC,sBAAsB,CAaxB"}