@b10cks/client 0.9.6

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present – Coder's Cantina e.U.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,172 @@
+export declare class ApiClient {
+    private readonly baseUrl;
+    private readonly token;
+    private readonly vid;
+    private rv;
+    private readonly fetchClient;
+    constructor(options: B10cksApiClientOptions, url: URL);
+    get<T>(endpoint: Endpoint, params?: Omit<IBBaseQueryParams, 'token'>): Promise<T>;
+    getAll<T>(endpoint: Endpoint, params?: Omit<IBBaseQueryParams, 'token'>): Promise<T[]>;
+    private buildUrl;
+}
+
+export declare interface B10cksApiClientOptions {
+    baseUrl: string;
+    token: string;
+    version?: 'draft' | 'published';
+    fetchClient: FetchClient;
+}
+
+export declare type Endpoint = 'blocks' | 'contents' | `contents/${string}` | `datasources/${string}/entries` | 'datasources' | 'spaces/me';
+
+export declare type FetchClient = typeof fetch;
+
+declare interface IBBaseQueryParams extends IBPaginationParams, IBSortParams {
+    vid?: string;
+    version?: string;
+    token: string;
+}
+
+export declare interface IBBlock {
+    id: string;
+    name: string;
+    slug: string;
+    schema: string;
+    tags: string[] | null;
+    created_at: string;
+    updated_at: string;
+}
+
+declare interface IBCollectionResponse<T> {
+    data: T[];
+    links: {
+        first: string | null;
+        last: string | null;
+        prev: string | null;
+        next: string | null;
+    };
+}
+
+export declare interface IBContent<Content = IBContentBlock<string> & {
+    [index: string]: unknown;
+}> {
+    id: string;
+    slug: string;
+    name: string;
+    content: Content;
+    type: string;
+    parent_id: string | null;
+    full_slug: string;
+    language_iso: string;
+    published_at: string | null;
+    created_at: string;
+    updated_at: string;
+}
+
+declare interface IBContentBlock<T extends string> {
+    id?: string;
+    block?: T;
+    _editable?: string;
+}
+
+declare interface IBContentQueryParams extends IBBaseQueryParams {
+    slug?: string;
+    full_slug?: string;
+    language_iso?: string;
+    type?: string;
+    parent_id?: string;
+}
+
+declare interface IBContentRelation {
+    id: string;
+    name: string;
+    slug: string;
+    full_slug: string;
+    language_iso: string;
+    published_at: string | null;
+    created_at: string;
+    updated_at: string;
+}
+
+declare interface IBDataEntry {
+    id: string;
+    key: string;
+    value: string;
+    updated_at: string;
+}
+
+declare interface IBDataSource {
+    id: string;
+    name: string;
+    slug: string;
+    dimensions: string[] | null;
+    created_at: string;
+    updated_at: string;
+}
+
+declare interface IBMeta {
+    current_page: number;
+    from: number;
+    last_page: number;
+    links: IBMetaLink[];
+    path: string;
+    per_page: number;
+    to: number;
+    total: number;
+}
+
+declare interface IBMetaLink {
+    url: string | null;
+    label: string | null;
+    active: boolean;
+}
+
+declare interface IBPaginationParams {
+    page?: number;
+    per_page?: number;
+}
+
+declare interface IBRedirect {
+    source: string;
+    target: string;
+    status_code: number;
+}
+
+export declare interface IBResponse<T> {
+    data: T;
+    rv?: string | number;
+}
+
+declare interface IBSortParams {
+    sort?: string;
+}
+
+declare interface IBSpace {
+    id: string;
+    name: string;
+    updated_at: string;
+}
+
+export declare namespace types {
+    export {
+        IBResponse,
+        IBCollectionResponse,
+        IBMetaLink,
+        IBMeta,
+        IBContentRelation,
+        IBContent,
+        IBContentBlock,
+        IBDataEntry,
+        IBPaginationParams,
+        IBSortParams,
+        IBBaseQueryParams,
+        IBBlock,
+        IBDataSource,
+        IBSpace,
+        IBRedirect,
+        IBContentQueryParams,
+        B10cksApiClientOptions
+    }
+}
+
+export { }

package/dist/index.js

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=Object.freeze(Object.defineProperty({__proto__:null},Symbol.toStringTag,{value:"Module"}));class c{baseUrl;token;vid;rv=0;fetchClient;constructor(e,s){this.baseUrl=e.baseUrl.endsWith("/")?e.baseUrl.slice(0,-1):e.baseUrl,this.token=e.token,this.fetchClient=e.fetchClient,this.vid=s.searchParams.get("b10cks_vid")||e.version||"published",this.rv=s.searchParams.get("b10cks_rv")??this.rv}async get(e,s={}){const t=this.buildUrl(e,{vid:this.vid,...s,rv:this.rv,token:this.token}),r=await this.fetchClient(t);return r.rv&&(this.rv=r.rv),r}async getAll(e,s={}){const t=await this.get(e,{...s,page:1});if(!t.meta||t.meta.last_page<=1)return"data"in t?t.data:t;const r=Array.from({length:t.meta.last_page},(i,l)=>this.get(e,{...s,page:l+1}));return(await Promise.all(r)).flatMap(i=>i.data)}buildUrl(e,s){const t=new URL(`${this.baseUrl}/v1/${e}`);return Object.entries(s).forEach(([r,a])=>{a!=null&&t.searchParams.append(r,String(a))}),t.toString()}}exports.ApiClient=c;exports.types=n;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["import type { B10cksApiClientOptions, IBBaseQueryParams, IBCollectionResponse, IBMeta, IBResponse, } from './types'\n\nexport type FetchClient = typeof fetch\nexport type Endpoint = 'blocks' | 'contents' | `contents/${string}` | `datasources/${string}/entries` | 'datasources' | 'spaces/me'\n\nexport * as types from './types'\nexport type { IBBlock, IBResponse, IBContent, B10cksApiClientOptions } from './types'\n\nexport class ApiClient {\n  private readonly baseUrl: string\n  private readonly token: string\n  private readonly vid: string | null\n  private rv: string | number = 0\n  private readonly fetchClient: FetchClient\n\n  constructor(options: B10cksApiClientOptions, url: URL) {\n    this.baseUrl = options.baseUrl.endsWith('/') ? options.baseUrl.slice(0, -1) : options.baseUrl\n    this.token = options.token\n    this.fetchClient = options.fetchClient\n\n    this.vid = url.searchParams.get('b10cks_vid') || options.version || 'published'\n    this.rv = url.searchParams.get('b10cks_rv') ?? this.rv\n  }\n\n  async get<T>(endpoint: Endpoint, params: Omit<IBBaseQueryParams, 'token'> = {}): Promise<T> {\n    const url = this.buildUrl(endpoint, {\n      vid: this.vid,\n      ...params,\n      rv: this.rv,\n      token: this.token\n    })\n\n    const response = await this.fetchClient(url) as unknown as IBResponse<T>\n    if (response.rv) {\n      this.rv = response.rv\n    }\n\n    return response as T\n  }\n\n  async getAll<T>(endpoint: Endpoint, params: Omit<IBBaseQueryParams, 'token'> = {}): Promise<T[]> {\n    const response = await this.get<IBCollectionResponse<T> & { meta?: IBMeta }>(\n      endpoint,\n      { ...params, page: 1 }\n    )\n\n    if (!response.meta || response.meta.last_page <= 1) {\n      return 'data' in response ? response.data : (response as unknown as T[])\n    }\n\n    const pageRequests = Array.from(\n      { length: response.meta.last_page },\n      (_, i) => this.get<IBCollectionResponse<T>>(endpoint, { ...params, page: i + 1 })\n    )\n\n    const allResponses = await Promise.all(pageRequests)\n\n    return allResponses.flatMap(r => r.data)\n  }\n\n  private buildUrl(endpoint: string, params: Record<string, unknown>): string {\n    const url = new URL(`${this.baseUrl}/v1/${endpoint}`)\n\n    Object.entries(params).forEach(([key, value]) => {\n      if (value !== undefined && value !== null) {\n        url.searchParams.append(key, String(value))\n      }\n    })\n\n    return url.toString()\n  }\n}"],"names":["ApiClient","options","url","endpoint","params","response","pageRequests","_","i","r","key","value"],"mappings":"mLAQO,MAAMA,CAAU,CACJ,QACA,MACA,IACT,GAAsB,EACb,YAEjB,YAAYC,EAAiCC,EAAU,CACrD,KAAK,QAAUD,EAAQ,QAAQ,SAAS,GAAG,EAAIA,EAAQ,QAAQ,MAAM,EAAG,EAAE,EAAIA,EAAQ,QACtF,KAAK,MAAQA,EAAQ,MACrB,KAAK,YAAcA,EAAQ,YAE3B,KAAK,IAAMC,EAAI,aAAa,IAAI,YAAY,GAAKD,EAAQ,SAAW,YACpE,KAAK,GAAKC,EAAI,aAAa,IAAI,WAAW,GAAK,KAAK,EACtD,CAEA,MAAM,IAAOC,EAAoBC,EAA2C,GAAgB,CAC1F,MAAMF,EAAM,KAAK,SAASC,EAAU,CAClC,IAAK,KAAK,IACV,GAAGC,EACH,GAAI,KAAK,GACT,MAAO,KAAK,KAAA,CACb,EAEKC,EAAW,MAAM,KAAK,YAAYH,CAAG,EAC3C,OAAIG,EAAS,KACX,KAAK,GAAKA,EAAS,IAGdA,CACT,CAEA,MAAM,OAAUF,EAAoBC,EAA2C,GAAkB,CAC/F,MAAMC,EAAW,MAAM,KAAK,IAC1BF,EACA,CAAE,GAAGC,EAAQ,KAAM,CAAA,CAAE,EAGvB,GAAI,CAACC,EAAS,MAAQA,EAAS,KAAK,WAAa,EAC/C,MAAO,SAAUA,EAAWA,EAAS,KAAQA,EAG/C,MAAMC,EAAe,MAAM,KACzB,CAAE,OAAQD,EAAS,KAAK,SAAA,EACxB,CAACE,EAAGC,IAAM,KAAK,IAA6BL,EAAU,CAAE,GAAGC,EAAQ,KAAMI,EAAI,CAAA,CAAG,CAAA,EAKlF,OAFqB,MAAM,QAAQ,IAAIF,CAAY,GAE/B,QAAQG,GAAKA,EAAE,IAAI,CACzC,CAEQ,SAASN,EAAkBC,EAAyC,CAC1E,MAAMF,EAAM,IAAI,IAAI,GAAG,KAAK,OAAO,OAAOC,CAAQ,EAAE,EAEpD,cAAO,QAAQC,CAAM,EAAE,QAAQ,CAAC,CAACM,EAAKC,CAAK,IAAM,CACpBA,GAAU,MACnCT,EAAI,aAAa,OAAOQ,EAAK,OAAOC,CAAK,CAAC,CAE9C,CAAC,EAEMT,EAAI,SAAA,CACb,CACF"}

package/dist/index.mjs

@@ -0,0 +1,46 @@
+const c = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null
+}, Symbol.toStringTag, { value: "Module" }));
+class h {
+  baseUrl;
+  token;
+  vid;
+  rv = 0;
+  fetchClient;
+  constructor(e, s) {
+    this.baseUrl = e.baseUrl.endsWith("/") ? e.baseUrl.slice(0, -1) : e.baseUrl, this.token = e.token, this.fetchClient = e.fetchClient, this.vid = s.searchParams.get("b10cks_vid") || e.version || "published", this.rv = s.searchParams.get("b10cks_rv") ?? this.rv;
+  }
+  async get(e, s = {}) {
+    const t = this.buildUrl(e, {
+      vid: this.vid,
+      ...s,
+      rv: this.rv,
+      token: this.token
+    }), r = await this.fetchClient(t);
+    return r.rv && (this.rv = r.rv), r;
+  }
+  async getAll(e, s = {}) {
+    const t = await this.get(
+      e,
+      { ...s, page: 1 }
+    );
+    if (!t.meta || t.meta.last_page <= 1)
+      return "data" in t ? t.data : t;
+    const r = Array.from(
+      { length: t.meta.last_page },
+      (i, l) => this.get(e, { ...s, page: l + 1 })
+    );
+    return (await Promise.all(r)).flatMap((i) => i.data);
+  }
+  buildUrl(e, s) {
+    const t = new URL(`${this.baseUrl}/v1/${e}`);
+    return Object.entries(s).forEach(([r, a]) => {
+      a != null && t.searchParams.append(r, String(a));
+    }), t.toString();
+  }
+}
+export {
+  h as ApiClient,
+  c as types
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../src/index.ts"],"sourcesContent":["import type { B10cksApiClientOptions, IBBaseQueryParams, IBCollectionResponse, IBMeta, IBResponse, } from './types'\n\nexport type FetchClient = typeof fetch\nexport type Endpoint = 'blocks' | 'contents' | `contents/${string}` | `datasources/${string}/entries` | 'datasources' | 'spaces/me'\n\nexport * as types from './types'\nexport type { IBBlock, IBResponse, IBContent, B10cksApiClientOptions } from './types'\n\nexport class ApiClient {\n  private readonly baseUrl: string\n  private readonly token: string\n  private readonly vid: string | null\n  private rv: string | number = 0\n  private readonly fetchClient: FetchClient\n\n  constructor(options: B10cksApiClientOptions, url: URL) {\n    this.baseUrl = options.baseUrl.endsWith('/') ? options.baseUrl.slice(0, -1) : options.baseUrl\n    this.token = options.token\n    this.fetchClient = options.fetchClient\n\n    this.vid = url.searchParams.get('b10cks_vid') || options.version || 'published'\n    this.rv = url.searchParams.get('b10cks_rv') ?? this.rv\n  }\n\n  async get<T>(endpoint: Endpoint, params: Omit<IBBaseQueryParams, 'token'> = {}): Promise<T> {\n    const url = this.buildUrl(endpoint, {\n      vid: this.vid,\n      ...params,\n      rv: this.rv,\n      token: this.token\n    })\n\n    const response = await this.fetchClient(url) as unknown as IBResponse<T>\n    if (response.rv) {\n      this.rv = response.rv\n    }\n\n    return response as T\n  }\n\n  async getAll<T>(endpoint: Endpoint, params: Omit<IBBaseQueryParams, 'token'> = {}): Promise<T[]> {\n    const response = await this.get<IBCollectionResponse<T> & { meta?: IBMeta }>(\n      endpoint,\n      { ...params, page: 1 }\n    )\n\n    if (!response.meta || response.meta.last_page <= 1) {\n      return 'data' in response ? response.data : (response as unknown as T[])\n    }\n\n    const pageRequests = Array.from(\n      { length: response.meta.last_page },\n      (_, i) => this.get<IBCollectionResponse<T>>(endpoint, { ...params, page: i + 1 })\n    )\n\n    const allResponses = await Promise.all(pageRequests)\n\n    return allResponses.flatMap(r => r.data)\n  }\n\n  private buildUrl(endpoint: string, params: Record<string, unknown>): string {\n    const url = new URL(`${this.baseUrl}/v1/${endpoint}`)\n\n    Object.entries(params).forEach(([key, value]) => {\n      if (value !== undefined && value !== null) {\n        url.searchParams.append(key, String(value))\n      }\n    })\n\n    return url.toString()\n  }\n}"],"names":["ApiClient","options","url","endpoint","params","response","pageRequests","_","i","r","key","value"],"mappings":";;;AAQO,MAAMA,EAAU;AAAA,EACJ;AAAA,EACA;AAAA,EACA;AAAA,EACT,KAAsB;AAAA,EACb;AAAA,EAEjB,YAAYC,GAAiCC,GAAU;AACrD,SAAK,UAAUD,EAAQ,QAAQ,SAAS,GAAG,IAAIA,EAAQ,QAAQ,MAAM,GAAG,EAAE,IAAIA,EAAQ,SACtF,KAAK,QAAQA,EAAQ,OACrB,KAAK,cAAcA,EAAQ,aAE3B,KAAK,MAAMC,EAAI,aAAa,IAAI,YAAY,KAAKD,EAAQ,WAAW,aACpE,KAAK,KAAKC,EAAI,aAAa,IAAI,WAAW,KAAK,KAAK;AAAA,EACtD;AAAA,EAEA,MAAM,IAAOC,GAAoBC,IAA2C,IAAgB;AAC1F,UAAMF,IAAM,KAAK,SAASC,GAAU;AAAA,MAClC,KAAK,KAAK;AAAA,MACV,GAAGC;AAAA,MACH,IAAI,KAAK;AAAA,MACT,OAAO,KAAK;AAAA,IAAA,CACb,GAEKC,IAAW,MAAM,KAAK,YAAYH,CAAG;AAC3C,WAAIG,EAAS,OACX,KAAK,KAAKA,EAAS,KAGdA;AAAA,EACT;AAAA,EAEA,MAAM,OAAUF,GAAoBC,IAA2C,IAAkB;AAC/F,UAAMC,IAAW,MAAM,KAAK;AAAA,MAC1BF;AAAA,MACA,EAAE,GAAGC,GAAQ,MAAM,EAAA;AAAA,IAAE;AAGvB,QAAI,CAACC,EAAS,QAAQA,EAAS,KAAK,aAAa;AAC/C,aAAO,UAAUA,IAAWA,EAAS,OAAQA;AAG/C,UAAMC,IAAe,MAAM;AAAA,MACzB,EAAE,QAAQD,EAAS,KAAK,UAAA;AAAA,MACxB,CAACE,GAAGC,MAAM,KAAK,IAA6BL,GAAU,EAAE,GAAGC,GAAQ,MAAMI,IAAI,EAAA,CAAG;AAAA,IAAA;AAKlF,YAFqB,MAAM,QAAQ,IAAIF,CAAY,GAE/B,QAAQ,CAAAG,MAAKA,EAAE,IAAI;AAAA,EACzC;AAAA,EAEQ,SAASN,GAAkBC,GAAyC;AAC1E,UAAMF,IAAM,IAAI,IAAI,GAAG,KAAK,OAAO,OAAOC,CAAQ,EAAE;AAEpD,kBAAO,QAAQC,CAAM,EAAE,QAAQ,CAAC,CAACM,GAAKC,CAAK,MAAM;AAC/C,MAA2BA,KAAU,QACnCT,EAAI,aAAa,OAAOQ,GAAK,OAAOC,CAAK,CAAC;AAAA,IAE9C,CAAC,GAEMT,EAAI,SAAA;AAAA,EACb;AACF;"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@b10cks/client",
+  "license": "MIT",
+  "version": "0.9.6",
+  "author": "Michael Wallner @ Coder's Cantina",
+  "description": "Core b10cks API client",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/b10cks/sdk.git",
+    "directory": "packages/client"
+  },
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "source": "src/index.ts",
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "chalk": "^5.6.0",
+    "vite": "^7.1.4",
+    "vite-plugin-banner": "^0.8.1",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^3.2.4"
+  },
+  "release": {
+    "branches": [
+      "main"
+    ]
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite build --watch",
+    "test": "vitest",
+    "lint": "eslint . --ext .vue,.js,.jsx,.cjs,.mjs,.ts --fix",
+    "clean": "rm -rf dist"
+  }
+}