@makinbakin/sdk 0.0.1-rc.4 → 0.0.1-rc.40

package/utils/asset-id.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Pure assetId validators — shape/date checks only, no filesystem knowledge.
+ *
+ * An `assetId` has the form `YYYYMMDD-{slug}-{id8}` (NO extension) and names a
+ * directory in the asset store, sharded by its `YYYY-MM` prefix. These
+ * validators are the single home for that shape: the assets plugin resolves
+ * store paths through them, and any plugin handling externally-supplied ids
+ * (e.g. images references) gates on them before calling `ctx.assets`.
+ * Generation and path resolution stay in the assets plugin — this module is
+ * deliberately pure so it can live on the published SDK surface.
+ */
+/** `YYYY-MM` shard for a valid assetId, or null. Validates the date components. */
+export declare function yearMonthFromAssetId(assetId: string): string | null;
+/** True when an external-supplied id is safe to resolve (no separators/traversal). */
+export declare function isValidAssetId(assetId: string): boolean;

package/utils/index.d.ts

@@ -5,10 +5,30 @@
  * needs. The `format*` helpers are re-exported from `@bakin/core/format`
  * so plugins have a single import path instead of reaching into `@/lib/*`.
  */
-export { cn } from '../_internal/app/lib/utils';
-export { formatAge, formatSize, isStale } from '../_internal/core/format';
-export { brainstormActivityMessageFromCustom, runtimeChunkToBrainstormActivity, toBrainstormTimeline, } from '../_internal/app/components/integrated-brainstorm/activity';
-export { brainstormThreadId, normalizeBrainstormActivityForStorage, normalizeBrainstormActivityMessageForStorage, } from '../_internal/app/components/integrated-brainstorm/session';
-export type { BrainstormActivityInput, BrainstormTimelineActivityInput, BrainstormTimelineMessageInput, } from '../_internal/app/components/integrated-brainstorm/activity';
-export type { BrainstormActivityStorageInput, BrainstormActivityStorageRecord, } from '../_internal/app/components/integrated-brainstorm/session';
-export { readBrainstormSseResponse } from '../_internal/app/components/integrated-brainstorm/sse';
+export { healthError, healthHealthy, healthNotApplicable, healthObserved, healthResourceId, healthUnknown, healthWarning, } from '../_internal/core/health/observation-builders';
+/** Tailwind class merger (clsx + tailwind-merge). */
+export { cn } from '../_internal/ui/utils';
+export { focusRing, focusRingInset } from '../_internal/ui/utils';
+/** Pure assetId shape validators (see ./asset-id). */
+export { isValidAssetId, yearMonthFromAssetId } from './asset-id';
+/** Format a Date or ISO string as a relative age (e.g. "5m ago"). */
+export { formatAge } from '../_internal/core/format';
+/** Format an ISO timestamp as a calendar-aware absolute date+time (e.g. "Today 3:45 PM", "Jan 5 9:02 AM"). */
+export { formatDateTime } from '../_internal/core/format';
+/** Format a millisecond count as an elapsed duration (e.g. "42s", "3m 5s"); null when undefined. */
+export { formatDuration } from '../_internal/core/format';
+/** Format a byte count as a human-readable size string (e.g. "1.2 MB"). */
+export { formatSize } from '../_internal/core/format';
+/** Returns true if a timestamp is older than a configurable staleness threshold. */
+export { isStale } from '../_internal/core/format';
+/** Canonical thread id for embedded conversation surfaces (scope:entity:agent). */
+export { conversationThreadId } from '../_internal/app/components/conversation/thread-id';
+/** Record one streamed turn's chunks into persistable ConversationMessage rows. */
+export { createTurnRecorder, SUMMARY_MAX_CHARS, PREVIEW_MAX_CHARS } from '../_internal/app/components/conversation/turn-recorder';
+export type { TurnRecorder } from '../_internal/app/components/conversation/turn-recorder';
+/** Structured-value (JSON → human) renderers — labeled prose, one-line summary, tool-envelope unwrap. */
+export { humanizeKey, formatStructured, summarizeStructured, unwrapToolResult, type FormatStructuredOptions } from '../_internal/core/format';
+/** Fetch a plugin's own API route (`/api/plugins/<id>/<path>`) with JSON defaults. */
+export { pluginFetch } from './plugin-fetch';
+/** `pluginFetch` + JSON parse under a hard deadline (the plain-function twin of `usePluginJsonFetch`'s `timeoutMs`). */
+export { pluginFetchJson, type PluginFetchJsonOptions } from './plugin-fetch';