@tthr/server 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,124 @@
+/**
+ * @tthr/server - Tether server SDK
+ *
+ * Define queries, mutations, and actions for your Tether project.
+ */
+import { z, type ZodType } from 'zod';
+/**
+ * Execution context passed to function handlers
+ */
+export interface ExecutionContext {
+    auth: {
+        userId: string | null;
+        claims: Record<string, unknown>;
+    };
+}
+/**
+ * Query function definition
+ */
+export interface QueryDefinition<TArgs, TResult> {
+    args?: ZodType<TArgs>;
+    handler: (args: TArgs, ctx: ExecutionContext) => Promise<TResult> | TResult;
+}
+/**
+ * Mutation function definition
+ */
+export interface MutationDefinition<TArgs, TResult> {
+    args?: ZodType<TArgs>;
+    handler: (args: TArgs, ctx: ExecutionContext) => Promise<TResult> | TResult;
+}
+/**
+ * Action function definition
+ */
+export interface ActionDefinition<TArgs, TResult> {
+    args?: ZodType<TArgs>;
+    handler: (args: TArgs, ctx: ExecutionContext) => Promise<TResult> | TResult;
+}
+/**
+ * Define a query function
+ *
+ * Queries are read-only and can be subscribed to for realtime updates.
+ *
+ * @example
+ * ```ts
+ * export const list = query({
+ *   handler: async () => {
+ *     return db.posts.findMany();
+ *   },
+ * });
+ *
+ * export const byId = query({
+ *   args: z.object({ id: z.number() }),
+ *   handler: async ({ id }) => {
+ *     return db.posts.findById(id);
+ *   },
+ * });
+ * ```
+ */
+export declare function query<TArgs = void, TResult = unknown>(definition: QueryDefinition<TArgs, TResult> | ((ctx: ExecutionContext) => Promise<TResult> | TResult)): QueryDefinition<TArgs, TResult>;
+/**
+ * Define a mutation function
+ *
+ * Mutations modify data and trigger updates to subscribed queries.
+ *
+ * @example
+ * ```ts
+ * export const create = mutation({
+ *   args: z.object({
+ *     title: z.string(),
+ *     content: z.string(),
+ *   }),
+ *   handler: async ({ title, content }, { auth }) => {
+ *     return db.posts.insert({ title, content, authorId: auth.userId });
+ *   },
+ * });
+ * ```
+ */
+export declare function mutation<TArgs = void, TResult = unknown>(definition: MutationDefinition<TArgs, TResult>): MutationDefinition<TArgs, TResult>;
+/**
+ * Define an action function
+ *
+ * Actions are for side effects like HTTP calls or sending emails.
+ * They are not transactional and don't trigger subscription updates.
+ *
+ * @example
+ * ```ts
+ * export const sendEmail = action({
+ *   args: z.object({
+ *     to: z.string().email(),
+ *     subject: z.string(),
+ *     body: z.string(),
+ *   }),
+ *   handler: async ({ to, subject, body }) => {
+ *     await emailService.send({ to, subject, body });
+ *     return { sent: true };
+ *   },
+ * });
+ * ```
+ */
+export declare function action<TArgs = void, TResult = unknown>(definition: ActionDefinition<TArgs, TResult>): ActionDefinition<TArgs, TResult>;
+/**
+ * Server-side Tether client for direct function calls
+ */
+export interface ServerClientOptions {
+    url: string;
+    apiKey: string;
+}
+export declare class TetherServerClient {
+    private options;
+    constructor(options: ServerClientOptions);
+    /**
+     * Execute a query function
+     */
+    query<T = unknown>(name: string, args?: unknown): Promise<T>;
+    /**
+     * Execute a mutation function
+     */
+    mutation<T = unknown>(name: string, args?: unknown): Promise<T>;
+}
+/**
+ * Create a server-side Tether client
+ */
+export declare function createClient(options: ServerClientOptions): TetherServerClient;
+export { z };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,KAAK,EAAE,OAAO;IAC7C,IAAI,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACtB,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAC7E;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,KAAK,EAAE,OAAO;IAChD,IAAI,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACtB,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAC7E;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,KAAK,EAAE,OAAO;IAC9C,IAAI,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACtB,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAC7E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,OAAO,GAAG,OAAO,EACnD,UAAU,EAAE,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,GACpG,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,CAOjC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,GAAG,IAAI,EAAE,OAAO,GAAG,OAAO,EACtD,UAAU,EAAE,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,GAC7C,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,CAEpC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,MAAM,CAAC,KAAK,GAAG,IAAI,EAAE,OAAO,GAAG,OAAO,EACpD,UAAU,EAAE,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,GAC3C,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,CAElC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAsB;gBAEzB,OAAO,EAAE,mBAAmB;IAIxC;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAmBlE;;OAEG;IACG,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;CAkBtE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB,CAE7E;AAGD,OAAO,EAAE,CAAC,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,133 @@
+/**
+ * @tthr/server - Tether server SDK
+ *
+ * Define queries, mutations, and actions for your Tether project.
+ */
+import { z } from 'zod';
+/**
+ * Define a query function
+ *
+ * Queries are read-only and can be subscribed to for realtime updates.
+ *
+ * @example
+ * ```ts
+ * export const list = query({
+ *   handler: async () => {
+ *     return db.posts.findMany();
+ *   },
+ * });
+ *
+ * export const byId = query({
+ *   args: z.object({ id: z.number() }),
+ *   handler: async ({ id }) => {
+ *     return db.posts.findById(id);
+ *   },
+ * });
+ * ```
+ */
+export function query(definition) {
+    if (typeof definition === 'function') {
+        return {
+            handler: (_, ctx) => definition(ctx),
+        };
+    }
+    return definition;
+}
+/**
+ * Define a mutation function
+ *
+ * Mutations modify data and trigger updates to subscribed queries.
+ *
+ * @example
+ * ```ts
+ * export const create = mutation({
+ *   args: z.object({
+ *     title: z.string(),
+ *     content: z.string(),
+ *   }),
+ *   handler: async ({ title, content }, { auth }) => {
+ *     return db.posts.insert({ title, content, authorId: auth.userId });
+ *   },
+ * });
+ * ```
+ */
+export function mutation(definition) {
+    return definition;
+}
+/**
+ * Define an action function
+ *
+ * Actions are for side effects like HTTP calls or sending emails.
+ * They are not transactional and don't trigger subscription updates.
+ *
+ * @example
+ * ```ts
+ * export const sendEmail = action({
+ *   args: z.object({
+ *     to: z.string().email(),
+ *     subject: z.string(),
+ *     body: z.string(),
+ *   }),
+ *   handler: async ({ to, subject, body }) => {
+ *     await emailService.send({ to, subject, body });
+ *     return { sent: true };
+ *   },
+ * });
+ * ```
+ */
+export function action(definition) {
+    return definition;
+}
+export class TetherServerClient {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * Execute a query function
+     */
+    async query(name, args) {
+        const response = await fetch(`${this.options.url}/api/v1/query`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${this.options.apiKey}`,
+            },
+            body: JSON.stringify({ function: name, args }),
+        });
+        if (!response.ok) {
+            const error = await response.json().catch(() => ({ message: response.statusText }));
+            throw new Error(error.message || 'Query failed');
+        }
+        const result = await response.json();
+        return result.data;
+    }
+    /**
+     * Execute a mutation function
+     */
+    async mutation(name, args) {
+        const response = await fetch(`${this.options.url}/api/v1/mutation`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${this.options.apiKey}`,
+            },
+            body: JSON.stringify({ function: name, args }),
+        });
+        if (!response.ok) {
+            const error = await response.json().catch(() => ({ message: response.statusText }));
+            throw new Error(error.message || 'Mutation failed');
+        }
+        const result = await response.json();
+        return result.data;
+    }
+}
+/**
+ * Create a server-side Tether client
+ */
+export function createClient(options) {
+    return new TetherServerClient(options);
+}
+// Re-export zod for convenience
+export { z };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@tthr/server",
+  "version": "0.0.1",
+  "description": "Tether server SDK for Node.js/Bun/Deno",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.2"
+  }
+}