talizen 0.2.4 → 0.2.6

package/README.md

@@ -7,6 +7,7 @@ Talizen's frontend SDK package. It provides a small runtime client and shared ty
 - `talizen/cms`
 - `talizen/form`
 - `talizen/func`
+- `talizen/func-runtime`
 
 The package is designed to hold the platform-level APIs that frontend projects use directly, while project-specific CMS and form schema types can still be generated separately per project.
 
@@ -137,13 +138,35 @@ const result = await invoke<{ success: boolean }>("user/auth.login", {
 await invoke("user/auth", { email: "hi@talizen.com" });
 ```
 
+### Write function runtime code
+
+Func code can use TypeScript and import runtime-only helpers from `talizen/func-runtime`:
+
+```ts
+import { auth, db, cache } from "talizen/func-runtime";
+
+export function create(input: { title: string }) {
+  const user = auth.requireUser();
+  const row = db.insert("book", {
+    title: input.title,
+    user_id: user.id,
+    status: "draft",
+  });
+  cache.set(`book:${row.id}`, row, 60);
+  return { ok: true, id: row.id };
+}
+```
+
+`db`, `cache`, and Func `auth` are injected by the Talizen Func runtime. They are typed in this package for authoring, but they are not browser/Node general-purpose APIs.
+
 ## Package Layout
 
 - `talizen/core`: shared runtime config, request helpers, and base data types.
 - `talizen/auth`: project user register, login, logout, and current user helpers.
 - `talizen/cms`: CMS content types and content query APIs.
 - `talizen/form`: form submission helpers and related types.
-- `talizen/func`: custom function invocation helpers.
+- `talizen/func`: custom function invocation helpers such as `invoke`.
+- `talizen/func-runtime`: Func-runtime-only `db`, `cache`, and `auth` types.
 
 ## Publish
 

package/func-runtime.d.ts

@@ -0,0 +1,65 @@
+import type { AuthUser } from "./auth.js";
+export type DbOrderBy = string;
+export interface DbFilterCondition {
+    field_id?: string;
+    fieldId?: string;
+    operator: "equal" | "not_equal" | "in";
+    value?: unknown;
+    values?: unknown[];
+}
+export interface DbFilter {
+    match?: "and" | "or";
+    conditions?: DbFilterCondition[];
+}
+export interface DbQuery {
+    where?: Record<string, unknown>;
+    filter?: DbFilter;
+    limit?: number;
+    offset?: number;
+    order_by?: DbOrderBy;
+    orderBy?: DbOrderBy;
+}
+export type DbRecord<T extends Record<string, unknown> = Record<string, unknown>> = T & {
+    id: string;
+};
+export interface FuncDbRuntime {
+    get<T extends Record<string, unknown> = Record<string, unknown>>(table: string, id: string): DbRecord<T> | null;
+    query<T extends Record<string, unknown> = Record<string, unknown>>(table: string, query?: DbQuery): Array<DbRecord<T>>;
+    insert<T extends Record<string, unknown> = Record<string, unknown>>(table: string, data: T): DbRecord<T>;
+    update<T extends Record<string, unknown> = Record<string, unknown>>(table: string, id: string, data: Partial<T>): {
+        ok?: boolean;
+        updated?: boolean;
+    } | DbRecord<T>;
+    delete(table: string, id: string): {
+        ok?: boolean;
+        deleted?: boolean;
+    };
+}
+export interface FuncAuthRuntime {
+    currentUser(): AuthUser | null;
+    requireUser(): AuthUser;
+}
+export interface CacheSetOptions {
+    ttl?: number;
+    ttlSeconds?: number;
+}
+export interface FuncCacheRuntime {
+    get<T = unknown>(key: string): T | null;
+    set(key: string, value: unknown, ttlSeconds?: number): {
+        ok?: boolean;
+    };
+    set(key: string, value: unknown, options?: CacheSetOptions): {
+        ok?: boolean;
+    };
+    del(key: string): {
+        ok?: boolean;
+        deleted?: boolean;
+    };
+    incr(key: string, delta?: number): number;
+    expire(key: string, ttlSeconds: number): {
+        ok?: boolean;
+    };
+}
+export declare const db: FuncDbRuntime;
+export declare const auth: FuncAuthRuntime;
+export declare const cache: FuncCacheRuntime;

package/func-runtime.js

@@ -0,0 +1,21 @@
+function unavailable() {
+    throw new Error("talizen/func-runtime is only available inside Talizen Func runtime.");
+}
+export const db = {
+    get: unavailable,
+    query: unavailable,
+    insert: unavailable,
+    update: unavailable,
+    delete: unavailable,
+};
+export const auth = {
+    currentUser: unavailable,
+    requireUser: unavailable,
+};
+export const cache = {
+    get: unavailable,
+    set: unavailable,
+    del: unavailable,
+    incr: unavailable,
+    expire: unavailable,
+};

package/index.d.ts

@@ -3,7 +3,6 @@ export * from "./auth.js";
 export * from "./cms.js";
 export * from "./captcha-ui.js";
 export * from "./form.js";
-export * from "./func.js";
 export * from "./i18n.js";
 type OneOrMany<T> = T | Array<T>;
 export interface MetadataTitle {

package/index.js

@@ -3,5 +3,4 @@ export * from "./auth.js";
 export * from "./cms.js";
 export * from "./captcha-ui.js";
 export * from "./form.js";
-export * from "./func.js";
 export * from "./i18n.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "talizen",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "Talizen frontend SDK types for cms, form and core.",
   "type": "module",
   "license": "MIT",
@@ -40,6 +40,10 @@
       "types": "./func.d.ts",
       "import": "./func.js"
     },
+    "./func-runtime": {
+      "types": "./func-runtime.d.ts",
+      "import": "./func-runtime.js"
+    },
     "./i18n": {
       "types": "./i18n.d.ts",
       "import": "./i18n.js"