@estokad/sdk 0.1.0

package/LICENSE

@@ -0,0 +1,17 @@
+Copyright © 2026 Samarkand Industries OÜ. All rights reserved.
+
+Estokad is proprietary software. Source code in this repository is the
+confidential intellectual property of Samarkand Industries OÜ
+(registered Tallinn, Estonia).
+
+Permission to use, copy, modify, or distribute this software is granted
+only under a separate written agreement signed by Samarkand Industries
+OÜ. Without such agreement, no license is granted, expressed or implied.
+
+Public-facing components — the SDK packages published to npm under the
+`@estokad/*` scope, and the SDKs' published documentation — are licensed
+separately. See the LICENSE file inside each `packages/*` directory or
+the package's npm registry page for the terms that apply to that
+specific package.
+
+Contact: legal@samarkandindustries.com

package/README.md

@@ -0,0 +1,109 @@
+# @estokad/sdk
+
+Framework-agnostic TypeScript client for the Estokad content API. End-to-end typed: your `defineType()` schemas drive the response types, no codegen step.
+
+## Install
+
+```bash
+pnpm add @estokad/sdk
+```
+
+## Quickstart
+
+```ts
+import { createClient } from '@estokad/sdk'
+
+const cms = createClient({
+  workspace: 'my-workspace',
+  apiUrl: 'https://api.estokad.com',
+  apiKey: process.env.ESTOKAD_API_KEY!,
+})
+
+// Fetch a list
+const articles = await cms.list('article', { first: 20 })
+
+// Fetch by id or slug
+const article = await cms.fetch('article', 'launch-week-day-1')
+
+// Singleton
+const settings = await cms.singleton('siteSettings').fetch()
+
+// Mutations (require write or management scope)
+await cms.update('article', article.id, { title: 'Updated' })
+await cms.publish('article', article.id)
+```
+
+## Typing your responses
+
+Declare a `ContentTypes` interface and the SDK becomes fully typed:
+
+```ts
+import type { ContentTypes } from '@estokad/sdk'
+
+declare module '@estokad/sdk' {
+  interface ContentTypes {
+    article: {
+      title: string
+      body: string
+      publishedAt: string | null
+    }
+    siteSettings: {
+      siteName: string
+      ga4MeasurementId: string
+    }
+  }
+}
+
+// Now `articles[0].title` is typed as `string`, no `any` anywhere.
+```
+
+In a real project, the type generation step is automatic — see [`@estokad/cli`](https://www.npmjs.com/package/@estokad/cli) `estokad pull` which writes a `.estokad/types.ts` declaration file alongside your `schemas/*.ts` files.
+
+## Errors
+
+```ts
+import {
+  EstokadError,
+  NotFoundError,
+  ValidationError,
+  RateLimitError,
+  UnauthorizedError,
+} from '@estokad/sdk'
+
+try {
+  await cms.update('article', id, { title: '' })
+} catch (err) {
+  if (err instanceof ValidationError) {
+    console.error('field issues:', err.issues)
+  } else if (err instanceof RateLimitError) {
+    console.error('retry after seconds:', err.retryAfter)
+  }
+}
+```
+
+## GraphQL escape hatch
+
+```ts
+const result = await cms.gql<{ article: { title: string } }>(
+  `query($id: ID!) { article(id: $id) { title } }`,
+  { id: 'launch-week-day-1' },
+)
+```
+
+## Framework adapters
+
+Don't use this directly — use one of the adapters:
+
+- [`@estokad/next`](https://www.npmjs.com/package/@estokad/next) for Next.js (App Router + draft mode + visual edit).
+- [`@estokad/nuxt`](https://www.npmjs.com/package/@estokad/nuxt) for Nuxt 3.
+- [`@estokad/svelte`](https://www.npmjs.com/package/@estokad/svelte) for SvelteKit.
+
+Each wraps `createClient` with the framework's preferred conventions (cookies, server-side fetch, etc.).
+
+## Documentation
+
+Full reference at [`docs.estokad.com`](https://docs.estokad.com). AI-friendly index at [`docs.estokad.com/llms.txt`](https://docs.estokad.com/llms.txt).
+
+## License
+
+Apache-2.0. Estokad is a Samarkand Industries OÜ product.

package/dist/client.d.ts

@@ -0,0 +1,11 @@
+import { TypeClient } from './type-client.js';
+import type { ClientOptions, ContentTypes } from './types.js';
+export type Client = {
+    readonly [K in keyof ContentTypes]: TypeClient<ContentTypes[K]>;
+} & {
+    /** Run a raw GraphQL query against the workspace's `/graphql` endpoint.
+     *  Throws on transport errors and on top-level `errors[]`. */
+    readonly gql: <T>(query: string, variables?: Record<string, unknown>) => Promise<T>;
+};
+export declare function createClient(options: ClientOptions): Client;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE7D,MAAM,MAAM,MAAM,GAAG;IACnB,QAAQ,EAAE,CAAC,IAAI,MAAM,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;CAChE,GAAG;IACF;kEAC8D;IAC9D,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;CACpF,CAAA;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAyB3D"}

package/dist/client.js

@@ -0,0 +1,39 @@
+// createClient — the user-facing entry point.
+//
+// Returns a Proxy so `client.<typeName>` resolves to a TypeClient<T> at
+// runtime. The static type is computed from the `ContentTypes` interface
+// declared via module augmentation by consumers; without augmentation,
+// `Client` is `{}` and TypeScript stops you at the property access. The
+// Proxy still works at runtime for ad-hoc string access (testing, dev).
+//
+// The Proxy also exposes a non-typed-by-content `gql` method for raw
+// GraphQL access. Reference fields auto-resolve to nested objects on the
+// server side via DataLoader (M2.2b); consumers can write the GraphQL
+// query themselves until the codegen pipeline lands.
+import { graphqlRequest, resolveConfig } from './transport.js';
+import { TypeClient } from './type-client.js';
+export function createClient(options) {
+    const config = resolveConfig(options);
+    const cache = new Map();
+    return new Proxy({}, {
+        get(_target, prop) {
+            if (typeof prop !== 'string')
+                return undefined;
+            // Block introspection probes that would otherwise instantiate a
+            // bogus TypeClient (e.g. tools inspecting `then` to check for
+            // promise-likeness).
+            if (prop === 'then' || prop === 'toJSON' || prop.startsWith('_'))
+                return undefined;
+            if (prop === 'gql') {
+                return (query, variables = {}) => graphqlRequest(config, query, variables);
+            }
+            let client = cache.get(prop);
+            if (!client) {
+                client = new TypeClient(prop, config);
+                cache.set(prop, client);
+            }
+            return client;
+        },
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,EAAE;AACF,wEAAwE;AACxE,yEAAyE;AACzE,uEAAuE;AACvE,wEAAwE;AACxE,wEAAwE;AACxE,EAAE;AACF,qEAAqE;AACrE,yEAAyE;AACzE,sEAAsE;AACtE,qDAAqD;AAErD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAW7C,MAAM,UAAU,YAAY,CAAC,OAAsB;IACjD,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAAA;IACrC,MAAM,KAAK,GAAG,IAAI,GAAG,EAA+B,CAAA;IAEpD,OAAO,IAAI,KAAK,CAAC,EAAY,EAAE;QAC7B,GAAG,CAAC,OAAO,EAAE,IAAI;YACf,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAA;YAC9C,gEAAgE;YAChE,8DAA8D;YAC9D,qBAAqB;YACrB,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,OAAO,SAAS,CAAA;YAElF,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;gBACnB,OAAO,CAAI,KAAa,EAAE,YAAqC,EAAE,EAAE,EAAE,CACnE,cAAc,CAAI,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,CAAA;YAC/C,CAAC;YAED,IAAI,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;gBACrC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;YACzB,CAAC;YACD,OAAO,MAAM,CAAA;QACf,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,30 @@
+export declare class EstokadError extends Error {
+    readonly status: number;
+    readonly body: string;
+    constructor(message: string, status: number, body: string);
+}
+export declare class NotFoundError extends EstokadError {
+    constructor(body: string);
+}
+export declare class ValidationError extends EstokadError {
+    readonly issues: ReadonlyArray<{
+        readonly path: string;
+        readonly message: string;
+    }>;
+    constructor(body: string, issues: ReadonlyArray<{
+        readonly path: string;
+        readonly message: string;
+    }>);
+}
+export declare class RateLimitError extends EstokadError {
+    readonly retryAfter: number;
+    constructor(body: string, retryAfter: number);
+}
+export declare class UnauthorizedError extends EstokadError {
+    constructor(body: string);
+}
+export declare class WrongRegionError extends EstokadError {
+    readonly redirect: string;
+    constructor(body: string, redirect: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAGA,qBAAa,YAAa,SAAQ,KAAK;aAGnB,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,MAAM;gBAF5B,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM;CAK/B;AAED,qBAAa,aAAc,SAAQ,YAAY;gBACjC,IAAI,EAAE,MAAM;CAIzB;AAED,qBAAa,eAAgB,SAAQ,YAAY;aAG7B,MAAM,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;gBAD1F,IAAI,EAAE,MAAM,EACI,MAAM,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAK7F;AAED,qBAAa,cAAe,SAAQ,YAAY;aAG5B,UAAU,EAAE,MAAM;gBADlC,IAAI,EAAE,MAAM,EACI,UAAU,EAAE,MAAM;CAKrC;AAED,qBAAa,iBAAkB,SAAQ,YAAY;gBACrC,IAAI,EAAE,MAAM;CAIzB;AAED,qBAAa,gBAAiB,SAAQ,YAAY;aAG9B,QAAQ,EAAE,MAAM;gBADhC,IAAI,EAAE,MAAM,EACI,QAAQ,EAAE,MAAM;CAKnC"}

package/dist/errors.js

@@ -0,0 +1,49 @@
+// Structured errors for the Estokad SDK. Consumers do `instanceof` checks to
+// branch (per docs/api.md § 10).
+export class EstokadError extends Error {
+    status;
+    body;
+    constructor(message, status, body) {
+        super(message);
+        this.status = status;
+        this.body = body;
+        this.name = 'EstokadError';
+    }
+}
+export class NotFoundError extends EstokadError {
+    constructor(body) {
+        super('Not found', 404, body);
+        this.name = 'NotFoundError';
+    }
+}
+export class ValidationError extends EstokadError {
+    issues;
+    constructor(body, issues) {
+        super('Validation failed', 422, body);
+        this.issues = issues;
+        this.name = 'ValidationError';
+    }
+}
+export class RateLimitError extends EstokadError {
+    retryAfter;
+    constructor(body, retryAfter) {
+        super('Rate limited', 429, body);
+        this.retryAfter = retryAfter;
+        this.name = 'RateLimitError';
+    }
+}
+export class UnauthorizedError extends EstokadError {
+    constructor(body) {
+        super('Unauthorized', 401, body);
+        this.name = 'UnauthorizedError';
+    }
+}
+export class WrongRegionError extends EstokadError {
+    redirect;
+    constructor(body, redirect) {
+        super('Wrong region for this workspace', 308, body);
+        this.redirect = redirect;
+        this.name = 'WrongRegionError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,iCAAiC;AAEjC,MAAM,OAAO,YAAa,SAAQ,KAAK;IAGnB;IACA;IAHlB,YACE,OAAe,EACC,MAAc,EACd,IAAY;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAA;QAHE,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAQ;QAG5B,IAAI,CAAC,IAAI,GAAG,cAAc,CAAA;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,YAAY;IAC7C,YAAY,IAAY;QACtB,KAAK,CAAC,WAAW,EAAE,GAAG,EAAE,IAAI,CAAC,CAAA;QAC7B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAA;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,YAAY;IAG7B;IAFlB,YACE,IAAY,EACI,MAA0E;QAE1F,KAAK,CAAC,mBAAmB,EAAE,GAAG,EAAE,IAAI,CAAC,CAAA;QAFrB,WAAM,GAAN,MAAM,CAAoE;QAG1F,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,YAAY;IAG5B;IAFlB,YACE,IAAY,EACI,UAAkB;QAElC,KAAK,CAAC,cAAc,EAAE,GAAG,EAAE,IAAI,CAAC,CAAA;QAFhB,eAAU,GAAV,UAAU,CAAQ;QAGlC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,YAAY;IACjD,YAAY,IAAY;QACtB,KAAK,CAAC,cAAc,EAAE,GAAG,EAAE,IAAI,CAAC,CAAA;QAChC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;IACjC,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,YAAY;IAG9B;IAFlB,YACE,IAAY,EACI,QAAgB;QAEhC,KAAK,CAAC,iCAAiC,EAAE,GAAG,EAAE,IAAI,CAAC,CAAA;QAFnC,aAAQ,GAAR,QAAQ,CAAQ;QAGhC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAA;IAChC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { createClient } from './client.js';
+export type { Client } from './client.js';
+export { TypeClient } from './type-client.js';
+export { EstokadError, NotFoundError, RateLimitError, UnauthorizedError, ValidationError, WrongRegionError, } from './errors.js';
+export type { ClientOptions, ContentTypes, EntryEnvelope, EntryMeta, ListArgs } from './types.js';
+//# 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,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EACL,YAAY,EACZ,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,gBAAgB,GACjB,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { createClient } from './client.js';
+export { TypeClient } from './type-client.js';
+export { EstokadError, NotFoundError, RateLimitError, UnauthorizedError, ValidationError, WrongRegionError, } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EACL,YAAY,EACZ,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,gBAAgB,GACjB,MAAM,aAAa,CAAA"}

package/dist/transport.d.ts

@@ -0,0 +1,20 @@
+import type { ClientOptions } from './types.js';
+interface RequestOptions {
+    readonly method?: string;
+    readonly body?: unknown;
+    readonly idempotencyKey?: string;
+    readonly query?: Record<string, string | number | undefined>;
+}
+export interface ResolvedConfig {
+    readonly apiUrl: string;
+    readonly workspace: string;
+    readonly apiKey: string;
+    readonly fetch: typeof globalThis.fetch;
+}
+export declare function resolveConfig(options: ClientOptions): ResolvedConfig;
+export declare function request<T>(config: ResolvedConfig, path: string, opts?: RequestOptions): Promise<T>;
+/** Run a GraphQL operation against the workspace's `/graphql` endpoint.
+ *  Throws `EstokadError` if the response carries top-level `errors`. */
+export declare function graphqlRequest<T>(config: ResolvedConfig, query: string, variables?: Record<string, unknown>): Promise<T>;
+export {};
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAI/C,UAAU,cAAc;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAA;CAC7D;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CACxC;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,CAapE;AAED,wBAAsB,OAAO,CAAC,CAAC,EAC7B,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,CAAC,CAAC,CAyBZ;AAkBD;wEACwE;AACxE,wBAAsB,cAAc,CAAC,CAAC,EACpC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACtC,OAAO,CAAC,CAAC,CAAC,CA0BZ"}

package/dist/transport.js

@@ -0,0 +1,127 @@
+// HTTP transport for the SDK.
+//
+// Wraps fetch with auth, error mapping (docs/api.md § 8 status codes), and
+// idempotency keys for create. Other domains (graphql in M2.2b, webhooks in
+// later phases) reuse this same primitive.
+import { EstokadError, NotFoundError, RateLimitError, UnauthorizedError, ValidationError, WrongRegionError, } from './errors.js';
+const DEFAULT_REGION = 'eu-fra-1';
+export function resolveConfig(options) {
+    if (!options.workspace)
+        throw new EstokadError('workspace is required', 0, '');
+    if (!options.apiKey)
+        throw new EstokadError('apiKey is required', 0, '');
+    const region = options.region ?? DEFAULT_REGION;
+    const apiUrl = options.apiUrl ?? `https://${region.split('-')[0] ?? 'eu'}.api.estokad.eu`;
+    return {
+        apiUrl: apiUrl.replace(/\/$/, ''),
+        workspace: options.workspace,
+        apiKey: options.apiKey,
+        fetch: options.fetch ?? globalThis.fetch.bind(globalThis),
+    };
+}
+export async function request(config, path, opts = {}) {
+    const url = buildUrl(config, path, opts.query);
+    const headers = {
+        Authorization: `Bearer ${config.apiKey}`,
+        Accept: 'application/json',
+    };
+    const init = {
+        method: opts.method ?? 'GET',
+        headers,
+    };
+    if (opts.body !== undefined) {
+        headers['Content-Type'] = 'application/json';
+        init.body = JSON.stringify(opts.body);
+    }
+    if (opts.idempotencyKey) {
+        headers['Idempotency-Key'] = opts.idempotencyKey;
+    }
+    const res = await config.fetch(url, init);
+    if (!res.ok) {
+        throw await mapError(res);
+    }
+    // 204 No Content (delete)
+    if (res.status === 204)
+        return undefined;
+    return (await res.json());
+}
+function buildUrl(config, path, query) {
+    const base = `${config.apiUrl}/v1/${encodeURIComponent(config.workspace)}${path}`;
+    if (!query)
+        return base;
+    const params = new URLSearchParams();
+    for (const [k, v] of Object.entries(query)) {
+        if (v === undefined)
+            continue;
+        params.set(k, String(v));
+    }
+    const qs = params.toString();
+    return qs ? `${base}?${qs}` : base;
+}
+/** Run a GraphQL operation against the workspace's `/graphql` endpoint.
+ *  Throws `EstokadError` if the response carries top-level `errors`. */
+export async function graphqlRequest(config, query, variables = {}) {
+    const url = `${config.apiUrl}/v1/${encodeURIComponent(config.workspace)}/graphql`;
+    const res = await config.fetch(url, {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${config.apiKey}`,
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+        },
+        body: JSON.stringify({ query, variables }),
+    });
+    if (!res.ok) {
+        throw await mapError(res);
+    }
+    const body = (await res.json());
+    if (body.errors && body.errors.length > 0) {
+        throw new EstokadError(`GraphQL error: ${body.errors.map((e) => e.message).join(' / ')}`, 400, JSON.stringify(body.errors));
+    }
+    if (body.data === undefined) {
+        throw new EstokadError('GraphQL response missing data', 0, JSON.stringify(body));
+    }
+    return body.data;
+}
+async function mapError(res) {
+    let body = '';
+    try {
+        body = await res.text();
+    }
+    catch {
+        body = res.statusText;
+    }
+    const parsed = safeJson(body);
+    switch (res.status) {
+        case 401:
+            return new UnauthorizedError(body);
+        case 404:
+            return new NotFoundError(body);
+        case 422: {
+            const issues = Array.isArray(parsed.issues)
+                ? parsed.issues
+                : [];
+            return new ValidationError(body, issues);
+        }
+        case 429: {
+            const retryAfter = Number(res.headers.get('Retry-After') ?? '1');
+            return new RateLimitError(body, retryAfter);
+        }
+        case 308:
+        case 301: {
+            const redirect = String(parsed.redirect ?? '');
+            return new WrongRegionError(body, redirect);
+        }
+        default:
+            return new EstokadError(`API ${res.status}`, res.status, body);
+    }
+}
+function safeJson(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

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

package/dist/type-client.d.ts

@@ -0,0 +1,24 @@
+import { type ResolvedConfig } from './transport.js';
+import type { EntryEnvelope, ListArgs } from './types.js';
+export declare class TypeClient<T> {
+    private readonly typeName;
+    private readonly config;
+    constructor(typeName: string, config: ResolvedConfig);
+    /** Single fetch by id (or slug — pass `{ slug }` instead of `{ id }`).
+     *  Returns null on 404, matching the shape consumers expect from
+     *  getStaticProps / getServerSideProps. (M2.2c) */
+    get(args: {
+        id: string;
+    } | {
+        slug: string;
+    }): Promise<EntryEnvelope<T> | null>;
+    /** List with `first` / `offset`. Filters + orderBy + cursor pagination
+     *  arrive in M2.1b once the API exposes them. */
+    list(args?: ListArgs): Promise<EntryEnvelope<T>[]>;
+    create(data: Partial<T>): Promise<EntryEnvelope<T>>;
+    update(id: string, data: Partial<T>): Promise<EntryEnvelope<T>>;
+    publish(id: string): Promise<EntryEnvelope<T>>;
+    unpublish(id: string): Promise<EntryEnvelope<T>>;
+    delete(id: string): Promise<void>;
+}
+//# sourceMappingURL=type-client.d.ts.map

package/dist/type-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-client.d.ts","sourceRoot":"","sources":["../src/type-client.ts"],"names":[],"mappings":"AAMA,OAAO,EAAW,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAEzD,qBAAa,UAAU,CAAC,CAAC;IAErB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc;IAGzC;;uDAEmD;IAC7C,GAAG,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAcpF;qDACiD;IAC3C,IAAI,CAAC,IAAI,GAAE,QAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IActD,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IASnD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAS/D,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAS9C,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAShD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAOxC"}

package/dist/type-client.js

@@ -0,0 +1,72 @@
+// Per-content-type CRUD facade. One TypeClient per content type, exposed
+// via the Proxy in client.ts so consumers do `client.pressRelease.get(...)`.
+//
+// All operations are REST in M2.2; GraphQL transport for reads (with
+// reference resolution via DataLoader) lands in M2.2b.
+import { request } from './transport.js';
+export class TypeClient {
+    typeName;
+    config;
+    constructor(typeName, config) {
+        this.typeName = typeName;
+        this.config = config;
+    }
+    /** Single fetch by id (or slug — pass `{ slug }` instead of `{ id }`).
+     *  Returns null on 404, matching the shape consumers expect from
+     *  getStaticProps / getServerSideProps. (M2.2c) */
+    async get(args) {
+        const path = 'slug' in args
+            ? `/content/${encodeURIComponent(this.typeName)}/_slug/${encodeURIComponent(args.slug)}`
+            : `/content/${encodeURIComponent(this.typeName)}/${encodeURIComponent(args.id)}`;
+        try {
+            const body = await request(this.config, path);
+            return body.entry;
+        }
+        catch (err) {
+            if (isNotFound(err))
+                return null;
+            throw err;
+        }
+    }
+    /** List with `first` / `offset`. Filters + orderBy + cursor pagination
+     *  arrive in M2.1b once the API exposes them. */
+    async list(args = {}) {
+        const body = await request(this.config, `/content/${encodeURIComponent(this.typeName)}`, {
+            query: {
+                first: args.first ?? 20,
+                offset: args.offset ?? 0,
+            },
+        });
+        return body.entries;
+    }
+    async create(data) {
+        const body = await request(this.config, `/content/${encodeURIComponent(this.typeName)}`, { method: 'POST', body: data, idempotencyKey: cryptoRandomKey() });
+        return body.entry;
+    }
+    async update(id, data) {
+        const body = await request(this.config, `/content/${encodeURIComponent(this.typeName)}/${encodeURIComponent(id)}`, { method: 'PATCH', body: data });
+        return body.entry;
+    }
+    async publish(id) {
+        const body = await request(this.config, `/content/${encodeURIComponent(this.typeName)}/${encodeURIComponent(id)}/publish`, { method: 'POST' });
+        return body.entry;
+    }
+    async unpublish(id) {
+        const body = await request(this.config, `/content/${encodeURIComponent(this.typeName)}/${encodeURIComponent(id)}/unpublish`, { method: 'POST' });
+        return body.entry;
+    }
+    async delete(id) {
+        await request(this.config, `/content/${encodeURIComponent(this.typeName)}/${encodeURIComponent(id)}`, { method: 'DELETE' });
+    }
+}
+function isNotFound(err) {
+    return typeof err === 'object' && err !== null && err.status === 404;
+}
+function cryptoRandomKey() {
+    // Deterministic shape across Node + browsers + edge runtimes.
+    if (typeof globalThis.crypto !== 'undefined' && globalThis.crypto.randomUUID) {
+        return globalThis.crypto.randomUUID();
+    }
+    return Math.random().toString(36).slice(2) + Date.now().toString(36);
+}
+//# sourceMappingURL=type-client.js.map

package/dist/type-client.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,33 @@
+export interface ContentTypes {
+}
+export interface ClientOptions {
+    /** Workspace slug (e.g. `white-castle`). */
+    readonly workspace: string;
+    /** Region code; defaults to `eu-fra-1`. */
+    readonly region?: string;
+    /** API base URL. Defaults to `https://{region}.api.estokad.eu` if region
+     *  matches the public regions; for self-hosted / dev, set explicitly. */
+    readonly apiUrl?: string;
+    /** est_dlv_*, est_drf_*, or est_mgt_* per docs/api.md § 3. */
+    readonly apiKey: string;
+    /** True to read drafts; requires an `est_drf_*` or `est_mgt_*` key. */
+    readonly draft?: boolean;
+    /** Override fetch (testing). Defaults to global fetch. */
+    readonly fetch?: typeof globalThis.fetch;
+}
+export interface EntryMeta {
+    readonly publishedAt: string | null;
+    readonly updatedAt: string;
+    readonly createdAt: string;
+    readonly status: 'published' | 'draft';
+}
+/** Common shape every entry has on top of its content fields. */
+export type EntryEnvelope<T> = T & {
+    readonly id: string;
+    readonly _meta?: EntryMeta;
+};
+export interface ListArgs {
+    readonly first?: number;
+    readonly offset?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,YAAY;CAK5B;AAED,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB;6EACyE;IACzE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,uEAAuE;IACvE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;IACxB,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CACzC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAA;CACvC;AAED,iEAAiE;AACjE,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAC3B,CAAA;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB"}

package/dist/types.js

@@ -0,0 +1,18 @@
+// Shape declarations for the SDK.
+//
+// ContentTypes is the contract consumers extend via declaration merging
+// (per docs/schema-system.md § 9 and api.md § 10):
+//
+//   declare module '@estokad/sdk' {
+//     interface ContentTypes {
+//       pressRelease: PressRelease
+//       author: Author
+//     }
+//   }
+//
+// `estokad push` writes a generated d.ts that augments ContentTypes for
+// every type the workspace knows; consumers don't import the types
+// manually. Until that codegen is wired (M2.2b), consumers can declare-merge
+// by hand against any TS interface.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,EAAE;AACF,wEAAwE;AACxE,mDAAmD;AACnD,EAAE;AACF,oCAAoC;AACpC,+BAA+B;AAC/B,mCAAmC;AACnC,uBAAuB;AACvB,QAAQ;AACR,MAAM;AACN,EAAE;AACF,wEAAwE;AACxE,mEAAmE;AACnE,6EAA6E;AAC7E,oCAAoC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@estokad/sdk",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Framework-agnostic TypeScript client for the Estokad content API.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ELIASspaceMercer/estokad.git",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://docs.estokad.com/docs/api",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "lint": "eslint ."
+  }
+}