@trellisjs/plugin-datasource 0.1.0-alpha.1

package/dist/index.d.mts

@@ -0,0 +1,84 @@
+import { TrellisAPI } from '@trellisjs/core';
+
+/**
+ * Trellis 標準查詢協定 — 前端向後端發送的查詢格式。
+ * 簡潔、可移植、不依賴任何後端框架。
+ */
+interface TrellisQuery {
+    /** 目前頁碼（從 1 開始） */
+    page: number;
+    /** 每頁筆數 */
+    pageSize: number;
+    /** 排序條件 */
+    sort?: TrellisSortQuery[];
+    /** 篩選條件 */
+    filter?: TrellisFilterQuery;
+}
+/** 單一排序條件 */
+interface TrellisSortQuery {
+    columnId: string;
+    direction: 'asc' | 'desc';
+}
+/** 篩選條件 */
+interface TrellisFilterQuery {
+    /** 全域搜尋關鍵字 */
+    global?: string;
+    /** 單欄篩選值 */
+    columns?: Record<string, unknown>;
+}
+/**
+ * 後端標準回應格式。
+ * 所有 server-side 模式的後端都必須回傳這個結構。
+ */
+interface TrellisResponse<T = Record<string, unknown>> {
+    /** 當前頁的資料列 */
+    data: T[];
+    /** 總筆數（未篩選） */
+    total: number;
+    /** 篩選後筆數 */
+    filtered: number;
+}
+/**
+ * 資料源介面 — 所有資料源都要實作這個介面。
+ */
+interface TrellisDatasource<T = Record<string, unknown>> {
+    /** 根據查詢條件取得資料 */
+    fetch(query: TrellisQuery): Promise<TrellisResponse<T>>;
+}
+/**
+ * 遠端資料源設定
+ */
+interface RemoteDatasourceOptions {
+    /** API 端點 URL */
+    url: string;
+    /** HTTP 方法（預設 POST） */
+    method?: 'GET' | 'POST';
+    /** 自訂請求標頭 */
+    headers?: Record<string, string>;
+    /** 自訂查詢轉換（發送前處理） */
+    transformQuery?: (query: TrellisQuery) => unknown;
+    /** 自訂回應轉換（接收後處理） */
+    transformResponse?: (response: unknown) => TrellisResponse;
+}
+/**
+ * 從 Trellis 狀態建構查詢物件
+ */
+declare function buildQueryFromState(api: TrellisAPI): TrellisQuery;
+
+interface StaticDatasourceOptions<T> {
+    /** 自訂欄位值提取函式 */
+    columnAccessors?: Record<string, (row: T) => unknown>;
+}
+/**
+ * 建立靜態（本地）資料源。
+ * 在本地執行排序、篩選、分頁 — 不需要後端。
+ */
+declare function createStaticDatasource<T extends Record<string, unknown>>(data: T[], options?: StaticDatasourceOptions<T>): TrellisDatasource<T>;
+
+/**
+ * 建立遠端 API 資料源。
+ * 透過 fetch 向後端發送標準化查詢，並解析回應。
+ */
+declare function createRemoteDatasource<T = Record<string, unknown>>(options: RemoteDatasourceOptions): TrellisDatasource<T>;
+
+export { type RemoteDatasourceOptions, type TrellisDatasource, type TrellisFilterQuery, type TrellisQuery, type TrellisResponse, type TrellisSortQuery, buildQueryFromState, createRemoteDatasource, createStaticDatasource };

package/dist/index.d.ts

@@ -0,0 +1,84 @@
+import { TrellisAPI } from '@trellisjs/core';
+
+/**
+ * Trellis 標準查詢協定 — 前端向後端發送的查詢格式。
+ * 簡潔、可移植、不依賴任何後端框架。
+ */
+interface TrellisQuery {
+    /** 目前頁碼（從 1 開始） */
+    page: number;
+    /** 每頁筆數 */
+    pageSize: number;
+    /** 排序條件 */
+    sort?: TrellisSortQuery[];
+    /** 篩選條件 */
+    filter?: TrellisFilterQuery;
+}
+/** 單一排序條件 */
+interface TrellisSortQuery {
+    columnId: string;
+    direction: 'asc' | 'desc';
+}
+/** 篩選條件 */
+interface TrellisFilterQuery {
+    /** 全域搜尋關鍵字 */
+    global?: string;
+    /** 單欄篩選值 */
+    columns?: Record<string, unknown>;
+}
+/**
+ * 後端標準回應格式。
+ * 所有 server-side 模式的後端都必須回傳這個結構。
+ */
+interface TrellisResponse<T = Record<string, unknown>> {
+    /** 當前頁的資料列 */
+    data: T[];
+    /** 總筆數（未篩選） */
+    total: number;
+    /** 篩選後筆數 */
+    filtered: number;
+}
+/**
+ * 資料源介面 — 所有資料源都要實作這個介面。
+ */
+interface TrellisDatasource<T = Record<string, unknown>> {
+    /** 根據查詢條件取得資料 */
+    fetch(query: TrellisQuery): Promise<TrellisResponse<T>>;
+}
+/**
+ * 遠端資料源設定
+ */
+interface RemoteDatasourceOptions {
+    /** API 端點 URL */
+    url: string;
+    /** HTTP 方法（預設 POST） */
+    method?: 'GET' | 'POST';
+    /** 自訂請求標頭 */
+    headers?: Record<string, string>;
+    /** 自訂查詢轉換（發送前處理） */
+    transformQuery?: (query: TrellisQuery) => unknown;
+    /** 自訂回應轉換（接收後處理） */
+    transformResponse?: (response: unknown) => TrellisResponse;
+}
+/**
+ * 從 Trellis 狀態建構查詢物件
+ */
+declare function buildQueryFromState(api: TrellisAPI): TrellisQuery;
+
+interface StaticDatasourceOptions<T> {
+    /** 自訂欄位值提取函式 */
+    columnAccessors?: Record<string, (row: T) => unknown>;
+}
+/**
+ * 建立靜態（本地）資料源。
+ * 在本地執行排序、篩選、分頁 — 不需要後端。
+ */
+declare function createStaticDatasource<T extends Record<string, unknown>>(data: T[], options?: StaticDatasourceOptions<T>): TrellisDatasource<T>;
+
+/**
+ * 建立遠端 API 資料源。
+ * 透過 fetch 向後端發送標準化查詢，並解析回應。
+ */
+declare function createRemoteDatasource<T = Record<string, unknown>>(options: RemoteDatasourceOptions): TrellisDatasource<T>;
+
+export { type RemoteDatasourceOptions, type TrellisDatasource, type TrellisFilterQuery, type TrellisQuery, type TrellisResponse, type TrellisSortQuery, buildQueryFromState, createRemoteDatasource, createStaticDatasource };

package/dist/index.js

@@ -0,0 +1,161 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  buildQueryFromState: () => buildQueryFromState,
+  createRemoteDatasource: () => createRemoteDatasource,
+  createStaticDatasource: () => createStaticDatasource
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/types.ts
+function buildQueryFromState(api) {
+  const state = api.getState();
+  const query = {
+    page: state.pagination.page,
+    pageSize: state.pagination.pageSize
+  };
+  if (state.sorting.direction) {
+    query.sort = [{
+      columnId: state.sorting.columnId,
+      direction: state.sorting.direction
+    }];
+  }
+  if (state.filtering.query || Object.keys(state.filtering.columnFilters).length > 0) {
+    query.filter = {};
+    if (state.filtering.query) {
+      query.filter.global = state.filtering.query;
+    }
+    if (Object.keys(state.filtering.columnFilters).length > 0) {
+      query.filter.columns = { ...state.filtering.columnFilters };
+    }
+  }
+  return query;
+}
+
+// src/static-datasource.ts
+function createStaticDatasource(data, options) {
+  const columnAccessors = options?.columnAccessors ?? {};
+  function getValue(row, columnId) {
+    if (columnAccessors[columnId]) {
+      return columnAccessors[columnId](row);
+    }
+    return row[columnId];
+  }
+  function compareValues(a, b) {
+    if (a == null && b == null) return 0;
+    if (a == null) return -1;
+    if (b == null) return 1;
+    if (typeof a === "number" && typeof b === "number") return a - b;
+    return String(a).localeCompare(String(b));
+  }
+  return {
+    async fetch(query) {
+      let result = [...data];
+      const total = data.length;
+      if (query.filter?.global) {
+        const keyword = query.filter.global.toLowerCase();
+        result = result.filter(
+          (row) => Object.values(row).some(
+            (val) => val != null && String(val).toLowerCase().includes(keyword)
+          )
+        );
+      }
+      if (query.filter?.columns) {
+        for (const [colId, filterVal] of Object.entries(query.filter.columns)) {
+          if (filterVal == null || filterVal === "") continue;
+          const keyword = String(filterVal).toLowerCase();
+          result = result.filter((row) => {
+            const val = getValue(row, colId);
+            return val != null && String(val).toLowerCase().includes(keyword);
+          });
+        }
+      }
+      const filtered = result.length;
+      if (query.sort) {
+        for (const sort of query.sort) {
+          result.sort((a, b) => {
+            const valA = getValue(a, sort.columnId);
+            const valB = getValue(b, sort.columnId);
+            const cmp = compareValues(valA, valB);
+            return sort.direction === "desc" ? -cmp : cmp;
+          });
+        }
+      }
+      const start = (query.page - 1) * query.pageSize;
+      const end = start + query.pageSize;
+      const paged = result.slice(start, end);
+      return { data: paged, total, filtered };
+    }
+  };
+}
+
+// src/remote-datasource.ts
+function createRemoteDatasource(options) {
+  const {
+    url,
+    method = "POST",
+    headers = {},
+    transformQuery,
+    transformResponse
+  } = options;
+  return {
+    async fetch(query) {
+      const finalQuery = transformQuery ? transformQuery(query) : query;
+      let response;
+      if (method === "GET") {
+        const params = new URLSearchParams();
+        params.set("page", String(query.page));
+        params.set("pageSize", String(query.pageSize));
+        if (query.sort) params.set("sort", JSON.stringify(query.sort));
+        if (query.filter) params.set("filter", JSON.stringify(query.filter));
+        response = await fetch(`${url}?${params.toString()}`, {
+          method: "GET",
+          headers: { "Accept": "application/json", ...headers }
+        });
+      } else {
+        response = await fetch(url, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "Accept": "application/json",
+            ...headers
+          },
+          body: JSON.stringify(finalQuery)
+        });
+      }
+      if (!response.ok) {
+        throw new Error(
+          `Trellis datasource request failed: ${response.status}`
+        );
+      }
+      const raw = await response.json();
+      return transformResponse ? transformResponse(raw) : raw;
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildQueryFromState,
+  createRemoteDatasource,
+  createStaticDatasource
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/types.ts","../src/static-datasource.ts","../src/remote-datasource.ts"],"sourcesContent":["export type {\n  TrellisQuery,\n  TrellisSortQuery,\n  TrellisFilterQuery,\n  TrellisResponse,\n  TrellisDatasource,\n  RemoteDatasourceOptions,\n} from './types';\nexport { buildQueryFromState } from './types';\nexport { createStaticDatasource } from './static-datasource';\nexport { createRemoteDatasource } from './remote-datasource';\n","import type { TrellisAPI } from '@trellisjs/core';\n\n/**\n * Trellis 標準查詢協定 — 前端向後端發送的查詢格式。\n * 簡潔、可移植、不依賴任何後端框架。\n */\nexport interface TrellisQuery {\n  /** 目前頁碼（從 1 開始） */\n  page: number;\n  /** 每頁筆數 */\n  pageSize: number;\n  /** 排序條件 */\n  sort?: TrellisSortQuery[];\n  /** 篩選條件 */\n  filter?: TrellisFilterQuery;\n}\n\n/** 單一排序條件 */\nexport interface TrellisSortQuery {\n  columnId: string;\n  direction: 'asc' | 'desc';\n}\n\n/** 篩選條件 */\nexport interface TrellisFilterQuery {\n  /** 全域搜尋關鍵字 */\n  global?: string;\n  /** 單欄篩選值 */\n  columns?: Record<string, unknown>;\n}\n\n/**\n * 後端標準回應格式。\n * 所有 server-side 模式的後端都必須回傳這個結構。\n */\nexport interface TrellisResponse<T = Record<string, unknown>> {\n  /** 當前頁的資料列 */\n  data: T[];\n  /** 總筆數（未篩選） */\n  total: number;\n  /** 篩選後筆數 */\n  filtered: number;\n}\n\n/**\n * 資料源介面 — 所有資料源都要實作這個介面。\n */\nexport interface TrellisDatasource<T = Record<string, unknown>> {\n  /** 根據查詢條件取得資料 */\n  fetch(query: TrellisQuery): Promise<TrellisResponse<T>>;\n}\n\n/**\n * 遠端資料源設定\n */\nexport interface RemoteDatasourceOptions {\n  /** API 端點 URL */\n  url: string;\n  /** HTTP 方法（預設 POST） */\n  method?: 'GET' | 'POST';\n  /** 自訂請求標頭 */\n  headers?: Record<string, string>;\n  /** 自訂查詢轉換（發送前處理） */\n  transformQuery?: (query: TrellisQuery) => unknown;\n  /** 自訂回應轉換（接收後處理） */\n  transformResponse?: (response: unknown) => TrellisResponse;\n}\n\n/**\n * 從 Trellis 狀態建構查詢物件\n */\nexport function buildQueryFromState(api: TrellisAPI): TrellisQuery {\n  const state = api.getState();\n  const query: TrellisQuery = {\n    page: state.pagination.page,\n    pageSize: state.pagination.pageSize,\n  };\n\n  if (state.sorting.direction) {\n    query.sort = [{\n      columnId: state.sorting.columnId,\n      direction: state.sorting.direction,\n    }];\n  }\n\n  if (state.filtering.query || Object.keys(state.filtering.columnFilters).length > 0) {\n    query.filter = {};\n    if (state.filtering.query) {\n      query.filter.global = state.filtering.query;\n    }\n    if (Object.keys(state.filtering.columnFilters).length > 0) {\n      query.filter.columns = { ...state.filtering.columnFilters };\n    }\n  }\n\n  return query;\n}\n","import type { TrellisDatasource, TrellisQuery, TrellisResponse } from './types';\n\ninterface StaticDatasourceOptions<T> {\n  /** 自訂欄位值提取函式 */\n  columnAccessors?: Record<string, (row: T) => unknown>;\n}\n\n/**\n * 建立靜態（本地）資料源。\n * 在本地執行排序、篩選、分頁 — 不需要後端。\n */\nexport function createStaticDatasource<T extends Record<string, unknown>>(\n  data: T[],\n  options?: StaticDatasourceOptions<T>,\n): TrellisDatasource<T> {\n  const columnAccessors = options?.columnAccessors ?? {};\n\n  function getValue(row: T, columnId: string): unknown {\n    if (columnAccessors[columnId]) {\n      return columnAccessors[columnId](row);\n    }\n    return row[columnId];\n  }\n\n  function compareValues(a: unknown, b: unknown): number {\n    if (a == null && b == null) return 0;\n    if (a == null) return -1;\n    if (b == null) return 1;\n    if (typeof a === 'number' && typeof b === 'number') return a - b;\n    return String(a).localeCompare(String(b));\n  }\n\n  return {\n    async fetch(query: TrellisQuery): Promise<TrellisResponse<T>> {\n      let result = [...data];\n      const total = data.length;\n\n      // 篩選 — 全域搜尋\n      if (query.filter?.global) {\n        const keyword = query.filter.global.toLowerCase();\n        result = result.filter((row) =>\n          Object.values(row).some((val) =>\n            val != null && String(val).toLowerCase().includes(keyword),\n          ),\n        );\n      }\n\n      // 篩選 — 單欄篩選\n      if (query.filter?.columns) {\n        for (const [colId, filterVal] of Object.entries(query.filter.columns)) {\n          if (filterVal == null || filterVal === '') continue;\n          const keyword = String(filterVal).toLowerCase();\n          result = result.filter((row) => {\n            const val = getValue(row, colId);\n            return val != null && String(val).toLowerCase().includes(keyword);\n          });\n        }\n      }\n\n      const filtered = result.length;\n\n      // 排序\n      if (query.sort) {\n        for (const sort of query.sort) {\n          result.sort((a, b) => {\n            const valA = getValue(a, sort.columnId);\n            const valB = getValue(b, sort.columnId);\n            const cmp = compareValues(valA, valB);\n            return sort.direction === 'desc' ? -cmp : cmp;\n          });\n        }\n      }\n\n      // 分頁\n      const start = (query.page - 1) * query.pageSize;\n      const end = start + query.pageSize;\n      const paged = result.slice(start, end);\n\n      return { data: paged, total, filtered };\n    },\n  };\n}\n","import type {\n  TrellisDatasource,\n  TrellisQuery,\n  TrellisResponse,\n  RemoteDatasourceOptions,\n} from './types';\n\n/**\n * 建立遠端 API 資料源。\n * 透過 fetch 向後端發送標準化查詢，並解析回應。\n */\nexport function createRemoteDatasource<T = Record<string, unknown>>(\n  options: RemoteDatasourceOptions,\n): TrellisDatasource<T> {\n  const {\n    url,\n    method = 'POST',\n    headers = {},\n    transformQuery,\n    transformResponse,\n  } = options;\n\n  return {\n    async fetch(query: TrellisQuery): Promise<TrellisResponse<T>> {\n      const finalQuery = transformQuery ? transformQuery(query) : query;\n\n      let response: Response;\n\n      if (method === 'GET') {\n        const params = new URLSearchParams();\n        params.set('page', String(query.page));\n        params.set('pageSize', String(query.pageSize));\n        if (query.sort) params.set('sort', JSON.stringify(query.sort));\n        if (query.filter) params.set('filter', JSON.stringify(query.filter));\n\n        response = await fetch(`${url}?${params.toString()}`, {\n          method: 'GET',\n          headers: { 'Accept': 'application/json', ...headers },\n        });\n      } else {\n        response = await fetch(url, {\n          method: 'POST',\n          headers: {\n            'Content-Type': 'application/json',\n            'Accept': 'application/json',\n            ...headers,\n          },\n          body: JSON.stringify(finalQuery),\n        });\n      }\n\n      if (!response.ok) {\n        throw new Error(\n          `Trellis datasource request failed: ${response.status}`,\n        );\n      }\n\n      const raw = await response.json();\n      return transformResponse\n        ? (transformResponse(raw) as TrellisResponse<T>)\n        : (raw as TrellisResponse<T>);\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,132 @@
+// src/types.ts
+function buildQueryFromState(api) {
+  const state = api.getState();
+  const query = {
+    page: state.pagination.page,
+    pageSize: state.pagination.pageSize
+  };
+  if (state.sorting.direction) {
+    query.sort = [{
+      columnId: state.sorting.columnId,
+      direction: state.sorting.direction
+    }];
+  }
+  if (state.filtering.query || Object.keys(state.filtering.columnFilters).length > 0) {
+    query.filter = {};
+    if (state.filtering.query) {
+      query.filter.global = state.filtering.query;
+    }
+    if (Object.keys(state.filtering.columnFilters).length > 0) {
+      query.filter.columns = { ...state.filtering.columnFilters };
+    }
+  }
+  return query;
+}
+
+// src/static-datasource.ts
+function createStaticDatasource(data, options) {
+  const columnAccessors = options?.columnAccessors ?? {};
+  function getValue(row, columnId) {
+    if (columnAccessors[columnId]) {
+      return columnAccessors[columnId](row);
+    }
+    return row[columnId];
+  }
+  function compareValues(a, b) {
+    if (a == null && b == null) return 0;
+    if (a == null) return -1;
+    if (b == null) return 1;
+    if (typeof a === "number" && typeof b === "number") return a - b;
+    return String(a).localeCompare(String(b));
+  }
+  return {
+    async fetch(query) {
+      let result = [...data];
+      const total = data.length;
+      if (query.filter?.global) {
+        const keyword = query.filter.global.toLowerCase();
+        result = result.filter(
+          (row) => Object.values(row).some(
+            (val) => val != null && String(val).toLowerCase().includes(keyword)
+          )
+        );
+      }
+      if (query.filter?.columns) {
+        for (const [colId, filterVal] of Object.entries(query.filter.columns)) {
+          if (filterVal == null || filterVal === "") continue;
+          const keyword = String(filterVal).toLowerCase();
+          result = result.filter((row) => {
+            const val = getValue(row, colId);
+            return val != null && String(val).toLowerCase().includes(keyword);
+          });
+        }
+      }
+      const filtered = result.length;
+      if (query.sort) {
+        for (const sort of query.sort) {
+          result.sort((a, b) => {
+            const valA = getValue(a, sort.columnId);
+            const valB = getValue(b, sort.columnId);
+            const cmp = compareValues(valA, valB);
+            return sort.direction === "desc" ? -cmp : cmp;
+          });
+        }
+      }
+      const start = (query.page - 1) * query.pageSize;
+      const end = start + query.pageSize;
+      const paged = result.slice(start, end);
+      return { data: paged, total, filtered };
+    }
+  };
+}
+
+// src/remote-datasource.ts
+function createRemoteDatasource(options) {
+  const {
+    url,
+    method = "POST",
+    headers = {},
+    transformQuery,
+    transformResponse
+  } = options;
+  return {
+    async fetch(query) {
+      const finalQuery = transformQuery ? transformQuery(query) : query;
+      let response;
+      if (method === "GET") {
+        const params = new URLSearchParams();
+        params.set("page", String(query.page));
+        params.set("pageSize", String(query.pageSize));
+        if (query.sort) params.set("sort", JSON.stringify(query.sort));
+        if (query.filter) params.set("filter", JSON.stringify(query.filter));
+        response = await fetch(`${url}?${params.toString()}`, {
+          method: "GET",
+          headers: { "Accept": "application/json", ...headers }
+        });
+      } else {
+        response = await fetch(url, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "Accept": "application/json",
+            ...headers
+          },
+          body: JSON.stringify(finalQuery)
+        });
+      }
+      if (!response.ok) {
+        throw new Error(
+          `Trellis datasource request failed: ${response.status}`
+        );
+      }
+      const raw = await response.json();
+      return transformResponse ? transformResponse(raw) : raw;
+    }
+  };
+}
+export {
+  buildQueryFromState,
+  createRemoteDatasource,
+  createStaticDatasource
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/static-datasource.ts","../src/remote-datasource.ts"],"sourcesContent":["import type { TrellisAPI } from '@trellisjs/core';\n\n/**\n * Trellis 標準查詢協定 — 前端向後端發送的查詢格式。\n * 簡潔、可移植、不依賴任何後端框架。\n */\nexport interface TrellisQuery {\n  /** 目前頁碼（從 1 開始） */\n  page: number;\n  /** 每頁筆數 */\n  pageSize: number;\n  /** 排序條件 */\n  sort?: TrellisSortQuery[];\n  /** 篩選條件 */\n  filter?: TrellisFilterQuery;\n}\n\n/** 單一排序條件 */\nexport interface TrellisSortQuery {\n  columnId: string;\n  direction: 'asc' | 'desc';\n}\n\n/** 篩選條件 */\nexport interface TrellisFilterQuery {\n  /** 全域搜尋關鍵字 */\n  global?: string;\n  /** 單欄篩選值 */\n  columns?: Record<string, unknown>;\n}\n\n/**\n * 後端標準回應格式。\n * 所有 server-side 模式的後端都必須回傳這個結構。\n */\nexport interface TrellisResponse<T = Record<string, unknown>> {\n  /** 當前頁的資料列 */\n  data: T[];\n  /** 總筆數（未篩選） */\n  total: number;\n  /** 篩選後筆數 */\n  filtered: number;\n}\n\n/**\n * 資料源介面 — 所有資料源都要實作這個介面。\n */\nexport interface TrellisDatasource<T = Record<string, unknown>> {\n  /** 根據查詢條件取得資料 */\n  fetch(query: TrellisQuery): Promise<TrellisResponse<T>>;\n}\n\n/**\n * 遠端資料源設定\n */\nexport interface RemoteDatasourceOptions {\n  /** API 端點 URL */\n  url: string;\n  /** HTTP 方法（預設 POST） */\n  method?: 'GET' | 'POST';\n  /** 自訂請求標頭 */\n  headers?: Record<string, string>;\n  /** 自訂查詢轉換（發送前處理） */\n  transformQuery?: (query: TrellisQuery) => unknown;\n  /** 自訂回應轉換（接收後處理） */\n  transformResponse?: (response: unknown) => TrellisResponse;\n}\n\n/**\n * 從 Trellis 狀態建構查詢物件\n */\nexport function buildQueryFromState(api: TrellisAPI): TrellisQuery {\n  const state = api.getState();\n  const query: TrellisQuery = {\n    page: state.pagination.page,\n    pageSize: state.pagination.pageSize,\n  };\n\n  if (state.sorting.direction) {\n    query.sort = [{\n      columnId: state.sorting.columnId,\n      direction: state.sorting.direction,\n    }];\n  }\n\n  if (state.filtering.query || Object.keys(state.filtering.columnFilters).length > 0) {\n    query.filter = {};\n    if (state.filtering.query) {\n      query.filter.global = state.filtering.query;\n    }\n    if (Object.keys(state.filtering.columnFilters).length > 0) {\n      query.filter.columns = { ...state.filtering.columnFilters };\n    }\n  }\n\n  return query;\n}\n","import type { TrellisDatasource, TrellisQuery, TrellisResponse } from './types';\n\ninterface StaticDatasourceOptions<T> {\n  /** 自訂欄位值提取函式 */\n  columnAccessors?: Record<string, (row: T) => unknown>;\n}\n\n/**\n * 建立靜態（本地）資料源。\n * 在本地執行排序、篩選、分頁 — 不需要後端。\n */\nexport function createStaticDatasource<T extends Record<string, unknown>>(\n  data: T[],\n  options?: StaticDatasourceOptions<T>,\n): TrellisDatasource<T> {\n  const columnAccessors = options?.columnAccessors ?? {};\n\n  function getValue(row: T, columnId: string): unknown {\n    if (columnAccessors[columnId]) {\n      return columnAccessors[columnId](row);\n    }\n    return row[columnId];\n  }\n\n  function compareValues(a: unknown, b: unknown): number {\n    if (a == null && b == null) return 0;\n    if (a == null) return -1;\n    if (b == null) return 1;\n    if (typeof a === 'number' && typeof b === 'number') return a - b;\n    return String(a).localeCompare(String(b));\n  }\n\n  return {\n    async fetch(query: TrellisQuery): Promise<TrellisResponse<T>> {\n      let result = [...data];\n      const total = data.length;\n\n      // 篩選 — 全域搜尋\n      if (query.filter?.global) {\n        const keyword = query.filter.global.toLowerCase();\n        result = result.filter((row) =>\n          Object.values(row).some((val) =>\n            val != null && String(val).toLowerCase().includes(keyword),\n          ),\n        );\n      }\n\n      // 篩選 — 單欄篩選\n      if (query.filter?.columns) {\n        for (const [colId, filterVal] of Object.entries(query.filter.columns)) {\n          if (filterVal == null || filterVal === '') continue;\n          const keyword = String(filterVal).toLowerCase();\n          result = result.filter((row) => {\n            const val = getValue(row, colId);\n            return val != null && String(val).toLowerCase().includes(keyword);\n          });\n        }\n      }\n\n      const filtered = result.length;\n\n      // 排序\n      if (query.sort) {\n        for (const sort of query.sort) {\n          result.sort((a, b) => {\n            const valA = getValue(a, sort.columnId);\n            const valB = getValue(b, sort.columnId);\n            const cmp = compareValues(valA, valB);\n            return sort.direction === 'desc' ? -cmp : cmp;\n          });\n        }\n      }\n\n      // 分頁\n      const start = (query.page - 1) * query.pageSize;\n      const end = start + query.pageSize;\n      const paged = result.slice(start, end);\n\n      return { data: paged, total, filtered };\n    },\n  };\n}\n","import type {\n  TrellisDatasource,\n  TrellisQuery,\n  TrellisResponse,\n  RemoteDatasourceOptions,\n} from './types';\n\n/**\n * 建立遠端 API 資料源。\n * 透過 fetch 向後端發送標準化查詢，並解析回應。\n */\nexport function createRemoteDatasource<T = Record<string, unknown>>(\n  options: RemoteDatasourceOptions,\n): TrellisDatasource<T> {\n  const {\n    url,\n    method = 'POST',\n    headers = {},\n    transformQuery,\n    transformResponse,\n  } = options;\n\n  return {\n    async fetch(query: TrellisQuery): Promise<TrellisResponse<T>> {\n      const finalQuery = transformQuery ? transformQuery(query) : query;\n\n      let response: Response;\n\n      if (method === 'GET') {\n        const params = new URLSearchParams();\n        params.set('page', String(query.page));\n        params.set('pageSize', String(query.pageSize));\n        if (query.sort) params.set('sort', JSON.stringify(query.sort));\n        if (query.filter) params.set('filter', JSON.stringify(query.filter));\n\n        response = await fetch(`${url}?${params.toString()}`, {\n          method: 'GET',\n          headers: { 'Accept': 'application/json', ...headers },\n        });\n      } else {\n        response = await fetch(url, {\n          method: 'POST',\n          headers: {\n            'Content-Type': 'application/json',\n            'Accept': 'application/json',\n            ...headers,\n          },\n          body: JSON.stringify(finalQuery),\n        });\n      }\n\n      if (!response.ok) {\n        throw new Error(\n          `Trellis datasource request failed: ${response.status}`,\n        );\n      }\n\n      const raw = await response.json();\n      return transformResponse\n        ? (transformResponse(raw) as TrellisResponse<T>)\n        : (raw as TrellisResponse<T>);\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@trellisjs/plugin-datasource",
+  "version": "0.1.0-alpha.1",
+  "description": "資料源插件 — 支援靜態資料與遠端 API",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  },
+  "peerDependencies": {
+    "@trellisjs/core": "workspace:*"
+  },
+  "devDependencies": {
+    "@trellisjs/core": "workspace:*",
+    "tsup": "^8.4.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.1.0"
+  },
+  "license": "MIT",
+  "sideEffects": false
+}