@stndrds/client 1.0.0-alpha.295

package/LICENSE

@@ -0,0 +1,111 @@
+STANDARDS SDK LICENSE
+Version 1.0, September 2026
+
+Copyright (c) 2025-2026 AND YOU CREATE SAS. All rights reserved.
+
+AND YOU CREATE, a French société par actions simplifiée with a share capital
+of EUR 500, registered with the Paris Trade and Companies Register under
+number 940 190 614, having its registered office at 60 rue François Ier,
+75008 Paris, France (VAT FR34940190614) ("AYC", "we"), is the sole owner of
+the software distributed under this license (the "SDK"): the source code,
+compiled code, type declarations, documentation and any accompanying files
+published in this package.
+
+This is not an open source license. The SDK is made available so that you
+can build software that communicates with the Standards platform operated by
+AYC ("Standards"). Reading the source is permitted; everything else is
+governed by the terms below. By installing, copying or using the SDK you
+("you", the "Licensee") accept them. If you do not accept them, do not use
+the SDK.
+
+1. LICENSE GRANT
+AYC grants you a limited, non-exclusive, non-transferable, non-sublicensable,
+revocable license to:
+  (a) install and use the SDK, in unmodified form, solely to develop, test
+      and run applications that communicate with a Standards tenant, workspace
+      or API that you are authorised to access under a valid agreement with
+      AYC or with an AYC customer; and
+  (b) make the copies of the SDK reasonably necessary for that purpose,
+      including copies produced by your build tooling and bundlers.
+
+2. RESTRICTIONS
+Except as expressly permitted in Section 1, you shall not, and shall not
+permit any third party to:
+  (a) modify, translate, adapt or create derivative works of the SDK;
+  (b) reverse engineer, decompile or disassemble the SDK, or otherwise attempt
+      to derive its design or internal structure, except to the extent that
+      applicable law expressly permits it despite this restriction (Articles
+      L.122-6-1 III and IV of the French Intellectual Property Code), in which
+      case you shall first request the information from AYC;
+  (c) distribute, sell, rent, lease, lend, sublicense, publish or otherwise
+      make the SDK, or any part of it, available to any third party, other
+      than as bundled inside an application described in Section 1(a);
+  (d) use the SDK, or any knowledge of its interfaces, formats, protocols or
+      schemas obtained through it, to build, train or improve a product or
+      service that competes with Standards, or to access Standards other than
+      through the interfaces AYC documents;
+  (e) use the SDK to interact with any Standards instance, tenant or API that
+      you are not authorised to access, or to circumvent any authentication,
+      authorisation, rate limit, licence key or other technical measure;
+  (f) remove, alter or obscure any copyright, trademark, licence or other
+      proprietary notice in the SDK; or
+  (g) use AYC's or Standards' names, logos or trademarks except to state
+      truthfully that your application uses the Standards SDK.
+
+3. OWNERSHIP
+The SDK is licensed, not sold. AYC and its licensors retain all right, title
+and interest in and to the SDK, including all intellectual property rights.
+No right is granted by implication, estoppel or otherwise. Any feedback or
+suggestion you provide about the SDK may be used by AYC without restriction
+or obligation.
+
+4. THIRD-PARTY COMPONENTS
+The SDK may include or depend on third-party open source components. Those
+components are governed by their own licences, which are identified in the
+package metadata and prevail over this license for those components only.
+
+5. UPDATES
+AYC may publish new versions of the SDK at any time. This license applies to
+each version you obtain unless that version is accompanied by a different
+licence. AYC has no obligation to maintain, support or update the SDK.
+
+6. TERM AND TERMINATION
+This license is effective until terminated. It terminates automatically,
+without notice, if you breach any of its terms. AYC may also terminate it on
+written notice if your agreement with AYC or with the AYC customer whose
+tenant you access ends. Upon termination you shall stop using the SDK and
+destroy every copy in your possession or control. Sections 2, 3, 7, 8 and 9
+survive termination.
+
+7. NO WARRANTY
+THE SDK IS PROVIDED "AS IS" AND "AS AVAILABLE", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING ANY WARRANTY OF MERCHANTABILITY, FITNESS FOR A
+PARTICULAR PURPOSE, TITLE OR NON-INFRINGEMENT, TO THE FULLEST EXTENT
+PERMITTED BY APPLICABLE LAW. AYC does not warrant that the SDK will be
+error-free or uninterrupted.
+
+8. LIMITATION OF LIABILITY
+TO THE FULLEST EXTENT PERMITTED BY APPLICABLE LAW, AYC SHALL NOT BE LIABLE
+FOR ANY INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL OR PUNITIVE DAMAGES, OR
+FOR ANY LOSS OF PROFITS, REVENUE, DATA OR GOODWILL, ARISING OUT OF OR IN
+CONNECTION WITH THE SDK OR THIS LICENSE. AYC'S TOTAL AGGREGATE LIABILITY
+UNDER THIS LICENSE SHALL NOT EXCEED ONE HUNDRED EUROS (EUR 100). Nothing in
+this license excludes or limits liability that cannot be excluded or limited
+under applicable law, including liability for gross negligence, wilful
+misconduct or death or personal injury caused by negligence.
+
+9. GOVERNING LAW AND JURISDICTION
+This license is governed by the laws of France. Any dispute arising out of or
+in connection with it shall be submitted to the exclusive jurisdiction of the
+courts of Paris, France, subject to any mandatory rule granting jurisdiction
+to another court.
+
+10. GENERAL
+If any provision of this license is held unenforceable, the remaining
+provisions remain in force. AYC's failure to enforce a provision is not a
+waiver of it. This license is the entire agreement between you and AYC about
+the SDK and supersedes any prior understanding about it, without prejudice to
+any separate agreement governing your access to Standards.
+
+To obtain a different licence, or for any question about this one, contact
+AND YOU CREATE SAS, 60 rue François Ier, 75008 Paris, France.

package/README.md

@@ -0,0 +1,62 @@
+# @stndrds/client
+
+Declare your schema with the `@stndrds/schema` fluent builders, sync it to a hosted Standards tenant, and operate typed records — from any Node ≥ 18 server process. No runtime, no NestJS.
+
+```bash
+pnpm add @stndrds/client
+```
+
+Everything you need — the builders, `createStandards`, `defineSchemaSource`, error classes — is exported from `@stndrds/client`. One package, one version.
+
+## 1. Declare a source
+
+```ts
+import { date, defineSchemaSource, object, select, text } from "@stndrds/client";
+
+export const incident = object({ name: "incidents", label: "Incident" })
+  .attribute(text({ name: "title", label: "Title" }).required())
+  .attribute(
+    select({ name: "severity", label: "Severity" }).options([
+      { value: "minor", label: "Minor" },
+      { value: "major", label: "Major" },
+      { value: "critical", label: "Critical" },
+    ])
+  )
+  .attribute(date({ name: "startedAt", label: "Started at" }))
+  .labelExpression("{{ title }}");
+
+export const statusSource = defineSchemaSource("status-site", { objects: [incident] });
+```
+
+## 2. Sync it (server-side only)
+
+```ts
+import { createStandards } from "@stndrds/client";
+
+const standards = createStandards({
+  baseUrl: process.env.STANDARDS_API_URL!,
+  apiKey: process.env.STANDARDS_API_KEY!,   // the key's role must grant architect:update (a key inherits its creator's roles unless created with a roleId)
+});
+
+const result = await standards.schema.sync(statusSource);
+// { applied: false, hash } when nothing changed — one GET, no write.
+```
+
+Objects you push are **system**: users can add their own attributes and views on top, but cannot delete or retype yours. Remove an object from the source and it is demoted to a custom object — its records survive. Never call `createStandards` with an API key in browser code; it refuses to.
+
+## 3. Typed records
+
+```ts
+const incidents = standards.from(incident);
+
+await incidents.create({ title: "API latency", severity: "major", startedAt: new Date() });
+const critical = await incidents.eq("severity", "critical").orderBy("startedAt", "desc").limit(10).fetch();
+```
+
+Inputs are typed from the builder (`severity` only accepts the three options); dates come back as `Date`.
+
+## Errors
+
+`StandardsAuthError` (401/403), `SchemaSourceConflictError` (409 from `schema.sync`, with `objectName` and `owner`), `SchemaSourceValidationError` (400 from `schema.sync`, server message verbatim), `StandardsRequestError` (any other non-2xx, with the server's `code`), `StandardsConfigurationError` (misuse). `schema.sync` never throws for "nothing to do".
+
+Licensed under the Standards SDK License 1.0 — see `LICENSE`. This package is not open source: it is provided to build applications that communicate with Standards.

package/dist/index.d.mts

@@ -0,0 +1,220 @@
+import { ObjectDefinition, ViewDefinition, ExtractRecord, ExtractRecordInputStrict, ExtractRecordUpdateStrict } from '@stndrds/schema';
+export { Attribute, CollectionPage, CollectionResponse, DuplicateError, ExtractRecord, ExtractRecordInput, ExtractRecordInputStrict, ExtractRecordStrict, ExtractRecordUpdate, ExtractRecordUpdateStrict, FilterCombinator, FilterOperator, FilterRule, FilterState, ForbiddenError, ListViewConfig, NotFoundError, ObjectDefinition, RecordMetadata, SCHEMA_SOURCE_ID_PATTERN, SchemaError, SchemaErrorCode, SortDirection, SortRule, ValidationError, ViewConfig, ViewDefinition, assertSchemaSourceId, canonicalStringify, checkbox, currency, date, detailView, document, formula, group, listView, location, multiselect, number, object, phone, relation, richtext, rollup, select, status, text, user } from '@stndrds/schema';
+
+/**
+ * Anything carrying the fluent builder's phantom types and a `build()` — the
+ * `object()` builder. Typed structurally so a consumer never has to import the
+ * builder class to satisfy a signature.
+ */
+interface ObjectBuilderLike {
+    readonly _types: {
+        record: unknown;
+        input: unknown;
+        update: unknown;
+    };
+    build(): ObjectDefinition;
+}
+type ViewInput = ViewDefinition | {
+    build(): ViewDefinition;
+};
+interface SchemaSource<TObjects extends readonly ObjectBuilderLike[] = readonly ObjectBuilderLike[]> {
+    readonly id: string;
+    /** sha256 hex of `canonicalStringify({ objects, views })` — the same digest the server recomputes. */
+    readonly hash: string;
+    readonly objects: ObjectDefinition[];
+    readonly views: ViewDefinition[];
+    /** The builders, kept for type inference in `standards.from(builder)`. */
+    readonly builders: TObjects;
+}
+/**
+ * Node's `node:crypto` is the only import in this package that is not a Web
+ * API; keeping it confined here leaves the rest of the client runtime-agnostic.
+ * Node >= 18 is the supported runtime for this slice; edge is a follow-up.
+ */
+declare function hashSchemaSource(payload: {
+    objects: ObjectDefinition[];
+    views: ViewDefinition[];
+}): string;
+/**
+ * Declare the schema an external codebase owns on a tenant. Builders are built
+ * once here and the hash is computed once; the builders themselves are kept so
+ * `from()` can infer record types.
+ */
+declare function defineSchemaSource<const TObjects extends readonly ObjectBuilderLike[]>(id: string, config: {
+    objects: TObjects;
+    views?: ViewInput[];
+}): SchemaSource<TObjects>;
+
+type Attr<TBuilder> = keyof ExtractRecord<TBuilder> & string;
+/**
+ * The builder's own attributes keep their exact types (a `select` refuses an
+ * option it does not declare); runtime-added custom attributes stay writable
+ * through the open index. `ExtractRecordInput`'s own index is typed
+ * `CustomAttributeValue`, which has no `Date` member and would reject the very
+ * date values the REST API accepts — hence the strict variant plus this index.
+ */
+type RecordInput<TBuilder> = ExtractRecordInputStrict<TBuilder> & {
+    [key: string]: unknown;
+};
+type RecordUpdate<TBuilder> = ExtractRecordUpdateStrict<TBuilder> & {
+    [key: string]: unknown;
+};
+/** The scalar shapes the fluent entry points accept; `FilterRule.value` is wider. */
+type RuleValue = string | number | boolean | null;
+interface FetchResult<TBuilder> {
+    records: ExtractRecord<TBuilder>[];
+    total: number | null;
+}
+interface RecordsQuery<TBuilder> {
+    eq(attribute: Attr<TBuilder>, value: RuleValue): RecordsQuery<TBuilder>;
+    neq(attribute: Attr<TBuilder>, value: RuleValue): RecordsQuery<TBuilder>;
+    gt(attribute: Attr<TBuilder>, value: RuleValue): RecordsQuery<TBuilder>;
+    gte(attribute: Attr<TBuilder>, value: RuleValue): RecordsQuery<TBuilder>;
+    lt(attribute: Attr<TBuilder>, value: RuleValue): RecordsQuery<TBuilder>;
+    lte(attribute: Attr<TBuilder>, value: RuleValue): RecordsQuery<TBuilder>;
+    contains(attribute: Attr<TBuilder>, value: RuleValue): RecordsQuery<TBuilder>;
+    notContains(attribute: Attr<TBuilder>, value: RuleValue): RecordsQuery<TBuilder>;
+    startsWith(attribute: Attr<TBuilder>, value: string): RecordsQuery<TBuilder>;
+    endsWith(attribute: Attr<TBuilder>, value: string): RecordsQuery<TBuilder>;
+    in(attribute: Attr<TBuilder>, values: string[]): RecordsQuery<TBuilder>;
+    notIn(attribute: Attr<TBuilder>, values: string[]): RecordsQuery<TBuilder>;
+    isEmpty(attribute: Attr<TBuilder>): RecordsQuery<TBuilder>;
+    isNotEmpty(attribute: Attr<TBuilder>): RecordsQuery<TBuilder>;
+    or(): RecordsQuery<TBuilder>;
+    orderBy(attribute: Attr<TBuilder>, direction?: "asc" | "desc"): RecordsQuery<TBuilder>;
+    limit(count: number): RecordsQuery<TBuilder>;
+    offset(count: number): RecordsQuery<TBuilder>;
+    search(query: string): RecordsQuery<TBuilder>;
+    fetch(): Promise<FetchResult<TBuilder>>;
+    single(): Promise<ExtractRecord<TBuilder> | null>;
+    get(id: string): Promise<ExtractRecord<TBuilder>>;
+    create(input: RecordInput<TBuilder>): Promise<ExtractRecord<TBuilder>>;
+    update(id: string, patch: RecordUpdate<TBuilder>): Promise<ExtractRecord<TBuilder>>;
+    delete(id: string): Promise<void>;
+}
+/**
+ * The builder shape `from(objectName: string)` stands in for: no declared
+ * attributes, so `ExtractRecord` resolves to an open record and `records` is a
+ * usable `Record<string, unknown> & RecordMetadata` array instead of `never[]`.
+ * `build()` returns `never` because there is no definition to build — the
+ * string overload never calls it.
+ */
+interface UntypedBuilder {
+    readonly _types: {
+        record: Record<string, unknown>;
+        input: Record<string, unknown>;
+        update: Record<string, unknown>;
+    };
+    build(): never;
+}
+/** What `standards.from("object-name")` hands back. */
+type UntypedRecordsQuery = RecordsQuery<UntypedBuilder>;
+/**
+ * The four verbs this module needs, typed non-generically: the real `Transport`
+ * satisfies it, and so does a hand-rolled stub, which a `Pick` of the generic
+ * signatures would reject.
+ */
+interface RecordsTransport {
+    get(path: string): Promise<unknown>;
+    post(path: string, body?: unknown): Promise<unknown>;
+    put(path: string, body?: unknown): Promise<unknown>;
+    delete(path: string): Promise<unknown>;
+}
+/** A builder gives typed records; a bare object name is the untyped escape hatch. */
+declare function createRecordsQuery<TBuilder extends ObjectBuilderLike>(transport: RecordsTransport, target: TBuilder): RecordsQuery<TBuilder>;
+declare function createRecordsQuery(transport: RecordsTransport, target: string): UntypedRecordsQuery;
+
+interface SchemaSourceSummary {
+    sourceId: string;
+    hash: string;
+    appliedAt: string;
+    objectNames: string[];
+}
+interface SyncResult {
+    applied: boolean;
+    hash: string;
+    objects?: {
+        created: number;
+        updated: number;
+        deleted: number;
+    };
+    views?: {
+        created: number;
+        updated: number;
+        adopted: number;
+        released: number;
+    };
+}
+/**
+ * The two verbs a sync needs, typed non-generically: the real `Transport`
+ * satisfies it, and so does a hand-rolled stub, which a `Pick` of the generic
+ * signatures would reject.
+ */
+interface SyncTransport {
+    get(path: string): Promise<unknown>;
+    put(path: string, body?: unknown): Promise<unknown>;
+}
+/** GET the remote summary; PUT only when the hash differs or the source was never pushed. */
+declare function syncSchemaSource(transport: SyncTransport, source: SchemaSource): Promise<SyncResult>;
+
+interface TransportConfig {
+    baseUrl: string;
+    apiKey: string;
+    tenantId?: string;
+    timeoutMs?: number;
+}
+declare function createTransport(config: TransportConfig): {
+    get<T = unknown>(path: string, params?: Record<string, unknown>): Promise<T>;
+    post<T = unknown>(path: string, body?: unknown): Promise<T>;
+    patch<T = unknown>(path: string, body?: unknown): Promise<T>;
+    put<T = unknown>(path: string, body?: unknown): Promise<T>;
+    delete<T = unknown>(path: string): Promise<T>;
+    getText: (path: string, params?: Record<string, unknown>) => Promise<string>;
+    postMultipart: <T>(path: string, form: FormData) => Promise<T>;
+};
+type Transport = ReturnType<typeof createTransport>;
+
+interface Standards {
+    schema: {
+        sync(source: SchemaSource): Promise<SyncResult>;
+    };
+    from<TBuilder extends ObjectBuilderLike>(builder: TBuilder): RecordsQuery<TBuilder>;
+    from(objectName: string): UntypedRecordsQuery;
+}
+declare function createStandards(config: TransportConfig): Standards;
+
+/**
+ * JSON delivers dates as ISO strings; the client knows the definition, so it
+ * revives system timestamps and every `date` attribute so `ExtractRecord` tells
+ * the truth on the wire. Nothing else is transformed.
+ */
+declare function reviveRecord<T extends Record<string, unknown>>(definition: ObjectDefinition | null, raw: T): T;
+
+/** Any non-2xx answer from a Standards API. `code` is the server's `SchemaErrorCode` when it sent one. */
+declare class StandardsRequestError extends Error {
+    readonly status: number;
+    readonly code?: string;
+    constructor(status: number, message: string, code?: string);
+}
+/** 401 or 403: the key is missing, invalid, or lacks the permission the route requires. */
+declare class StandardsAuthError extends StandardsRequestError {
+    constructor(status: number, message: string, code?: string);
+}
+/** 409 from `PUT /schema/sources/:id`: a name this source declares is owned by core, a bundle, or another source. */
+declare class SchemaSourceConflictError extends StandardsRequestError {
+    /** The object or `object:view` name that clashed. */
+    readonly objectName: string;
+    /** `core`, `bundle:<id>` or `source:<id>`. */
+    readonly owner: string;
+    constructor(status: number, message: string, code: string | undefined);
+}
+/** 400 from `PUT /schema/sources/:id`: bad id, oversize payload, hash mismatch, invalid definition, or an unresolved migration. */
+declare class SchemaSourceValidationError extends StandardsRequestError {
+    constructor(status: number, message: string, code: string | undefined);
+}
+/** The client was constructed in a way it refuses to run (e.g. an API key in a browser). */
+declare class StandardsConfigurationError extends Error {
+    constructor(message: string);
+}
+
+export { type FetchResult, type ObjectBuilderLike, type RecordInput, type RecordUpdate, type RecordsQuery, type SchemaSource, SchemaSourceConflictError, type SchemaSourceSummary, SchemaSourceValidationError, type Standards, StandardsAuthError, StandardsConfigurationError, StandardsRequestError, type SyncResult, type Transport, type TransportConfig, type UntypedBuilder, type UntypedRecordsQuery, createRecordsQuery, createStandards, createTransport, defineSchemaSource, hashSchemaSource, reviveRecord, syncSchemaSource };

package/dist/index.d.ts

@@ -0,0 +1,220 @@
+import { ObjectDefinition, ViewDefinition, ExtractRecord, ExtractRecordInputStrict, ExtractRecordUpdateStrict } from '@stndrds/schema';
+export { Attribute, CollectionPage, CollectionResponse, DuplicateError, ExtractRecord, ExtractRecordInput, ExtractRecordInputStrict, ExtractRecordStrict, ExtractRecordUpdate, ExtractRecordUpdateStrict, FilterCombinator, FilterOperator, FilterRule, FilterState, ForbiddenError, ListViewConfig, NotFoundError, ObjectDefinition, RecordMetadata, SCHEMA_SOURCE_ID_PATTERN, SchemaError, SchemaErrorCode, SortDirection, SortRule, ValidationError, ViewConfig, ViewDefinition, assertSchemaSourceId, canonicalStringify, checkbox, currency, date, detailView, document, formula, group, listView, location, multiselect, number, object, phone, relation, richtext, rollup, select, status, text, user } from '@stndrds/schema';
+
+/**
+ * Anything carrying the fluent builder's phantom types and a `build()` — the
+ * `object()` builder. Typed structurally so a consumer never has to import the
+ * builder class to satisfy a signature.
+ */
+interface ObjectBuilderLike {
+    readonly _types: {
+        record: unknown;
+        input: unknown;
+        update: unknown;
+    };
+    build(): ObjectDefinition;
+}
+type ViewInput = ViewDefinition | {
+    build(): ViewDefinition;
+};
+interface SchemaSource<TObjects extends readonly ObjectBuilderLike[] = readonly ObjectBuilderLike[]> {
+    readonly id: string;
+    /** sha256 hex of `canonicalStringify({ objects, views })` — the same digest the server recomputes. */
+    readonly hash: string;
+    readonly objects: ObjectDefinition[];
+    readonly views: ViewDefinition[];
+    /** The builders, kept for type inference in `standards.from(builder)`. */
+    readonly builders: TObjects;
+}
+/**
+ * Node's `node:crypto` is the only import in this package that is not a Web
+ * API; keeping it confined here leaves the rest of the client runtime-agnostic.
+ * Node >= 18 is the supported runtime for this slice; edge is a follow-up.
+ */
+declare function hashSchemaSource(payload: {
+    objects: ObjectDefinition[];
+    views: ViewDefinition[];
+}): string;
+/**
+ * Declare the schema an external codebase owns on a tenant. Builders are built
+ * once here and the hash is computed once; the builders themselves are kept so
+ * `from()` can infer record types.
+ */
+declare function defineSchemaSource<const TObjects extends readonly ObjectBuilderLike[]>(id: string, config: {
+    objects: TObjects;
+    views?: ViewInput[];
+}): SchemaSource<TObjects>;
+
+type Attr<TBuilder> = keyof ExtractRecord<TBuilder> & string;
+/**
+ * The builder's own attributes keep their exact types (a `select` refuses an
+ * option it does not declare); runtime-added custom attributes stay writable
+ * through the open index. `ExtractRecordInput`'s own index is typed
+ * `CustomAttributeValue`, which has no `Date` member and would reject the very
+ * date values the REST API accepts — hence the strict variant plus this index.
+ */
+type RecordInput<TBuilder> = ExtractRecordInputStrict<TBuilder> & {
+    [key: string]: unknown;
+};
+type RecordUpdate<TBuilder> = ExtractRecordUpdateStrict<TBuilder> & {
+    [key: string]: unknown;
+};
+/** The scalar shapes the fluent entry points accept; `FilterRule.value` is wider. */
+type RuleValue = string | number | boolean | null;
+interface FetchResult<TBuilder> {
+    records: ExtractRecord<TBuilder>[];
+    total: number | null;
+}
+interface RecordsQuery<TBuilder> {
+    eq(attribute: Attr<TBuilder>, value: RuleValue): RecordsQuery<TBuilder>;
+    neq(attribute: Attr<TBuilder>, value: RuleValue): RecordsQuery<TBuilder>;
+    gt(attribute: Attr<TBuilder>, value: RuleValue): RecordsQuery<TBuilder>;
+    gte(attribute: Attr<TBuilder>, value: RuleValue): RecordsQuery<TBuilder>;
+    lt(attribute: Attr<TBuilder>, value: RuleValue): RecordsQuery<TBuilder>;
+    lte(attribute: Attr<TBuilder>, value: RuleValue): RecordsQuery<TBuilder>;
+    contains(attribute: Attr<TBuilder>, value: RuleValue): RecordsQuery<TBuilder>;
+    notContains(attribute: Attr<TBuilder>, value: RuleValue): RecordsQuery<TBuilder>;
+    startsWith(attribute: Attr<TBuilder>, value: string): RecordsQuery<TBuilder>;
+    endsWith(attribute: Attr<TBuilder>, value: string): RecordsQuery<TBuilder>;
+    in(attribute: Attr<TBuilder>, values: string[]): RecordsQuery<TBuilder>;
+    notIn(attribute: Attr<TBuilder>, values: string[]): RecordsQuery<TBuilder>;
+    isEmpty(attribute: Attr<TBuilder>): RecordsQuery<TBuilder>;
+    isNotEmpty(attribute: Attr<TBuilder>): RecordsQuery<TBuilder>;
+    or(): RecordsQuery<TBuilder>;
+    orderBy(attribute: Attr<TBuilder>, direction?: "asc" | "desc"): RecordsQuery<TBuilder>;
+    limit(count: number): RecordsQuery<TBuilder>;
+    offset(count: number): RecordsQuery<TBuilder>;
+    search(query: string): RecordsQuery<TBuilder>;
+    fetch(): Promise<FetchResult<TBuilder>>;
+    single(): Promise<ExtractRecord<TBuilder> | null>;
+    get(id: string): Promise<ExtractRecord<TBuilder>>;
+    create(input: RecordInput<TBuilder>): Promise<ExtractRecord<TBuilder>>;
+    update(id: string, patch: RecordUpdate<TBuilder>): Promise<ExtractRecord<TBuilder>>;
+    delete(id: string): Promise<void>;
+}
+/**
+ * The builder shape `from(objectName: string)` stands in for: no declared
+ * attributes, so `ExtractRecord` resolves to an open record and `records` is a
+ * usable `Record<string, unknown> & RecordMetadata` array instead of `never[]`.
+ * `build()` returns `never` because there is no definition to build — the
+ * string overload never calls it.
+ */
+interface UntypedBuilder {
+    readonly _types: {
+        record: Record<string, unknown>;
+        input: Record<string, unknown>;
+        update: Record<string, unknown>;
+    };
+    build(): never;
+}
+/** What `standards.from("object-name")` hands back. */
+type UntypedRecordsQuery = RecordsQuery<UntypedBuilder>;
+/**
+ * The four verbs this module needs, typed non-generically: the real `Transport`
+ * satisfies it, and so does a hand-rolled stub, which a `Pick` of the generic
+ * signatures would reject.
+ */
+interface RecordsTransport {
+    get(path: string): Promise<unknown>;
+    post(path: string, body?: unknown): Promise<unknown>;
+    put(path: string, body?: unknown): Promise<unknown>;
+    delete(path: string): Promise<unknown>;
+}
+/** A builder gives typed records; a bare object name is the untyped escape hatch. */
+declare function createRecordsQuery<TBuilder extends ObjectBuilderLike>(transport: RecordsTransport, target: TBuilder): RecordsQuery<TBuilder>;
+declare function createRecordsQuery(transport: RecordsTransport, target: string): UntypedRecordsQuery;
+
+interface SchemaSourceSummary {
+    sourceId: string;
+    hash: string;
+    appliedAt: string;
+    objectNames: string[];
+}
+interface SyncResult {
+    applied: boolean;
+    hash: string;
+    objects?: {
+        created: number;
+        updated: number;
+        deleted: number;
+    };
+    views?: {
+        created: number;
+        updated: number;
+        adopted: number;
+        released: number;
+    };
+}
+/**
+ * The two verbs a sync needs, typed non-generically: the real `Transport`
+ * satisfies it, and so does a hand-rolled stub, which a `Pick` of the generic
+ * signatures would reject.
+ */
+interface SyncTransport {
+    get(path: string): Promise<unknown>;
+    put(path: string, body?: unknown): Promise<unknown>;
+}
+/** GET the remote summary; PUT only when the hash differs or the source was never pushed. */
+declare function syncSchemaSource(transport: SyncTransport, source: SchemaSource): Promise<SyncResult>;
+
+interface TransportConfig {
+    baseUrl: string;
+    apiKey: string;
+    tenantId?: string;
+    timeoutMs?: number;
+}
+declare function createTransport(config: TransportConfig): {
+    get<T = unknown>(path: string, params?: Record<string, unknown>): Promise<T>;
+    post<T = unknown>(path: string, body?: unknown): Promise<T>;
+    patch<T = unknown>(path: string, body?: unknown): Promise<T>;
+    put<T = unknown>(path: string, body?: unknown): Promise<T>;
+    delete<T = unknown>(path: string): Promise<T>;
+    getText: (path: string, params?: Record<string, unknown>) => Promise<string>;
+    postMultipart: <T>(path: string, form: FormData) => Promise<T>;
+};
+type Transport = ReturnType<typeof createTransport>;
+
+interface Standards {
+    schema: {
+        sync(source: SchemaSource): Promise<SyncResult>;
+    };
+    from<TBuilder extends ObjectBuilderLike>(builder: TBuilder): RecordsQuery<TBuilder>;
+    from(objectName: string): UntypedRecordsQuery;
+}
+declare function createStandards(config: TransportConfig): Standards;
+
+/**
+ * JSON delivers dates as ISO strings; the client knows the definition, so it
+ * revives system timestamps and every `date` attribute so `ExtractRecord` tells
+ * the truth on the wire. Nothing else is transformed.
+ */
+declare function reviveRecord<T extends Record<string, unknown>>(definition: ObjectDefinition | null, raw: T): T;
+
+/** Any non-2xx answer from a Standards API. `code` is the server's `SchemaErrorCode` when it sent one. */
+declare class StandardsRequestError extends Error {
+    readonly status: number;
+    readonly code?: string;
+    constructor(status: number, message: string, code?: string);
+}
+/** 401 or 403: the key is missing, invalid, or lacks the permission the route requires. */
+declare class StandardsAuthError extends StandardsRequestError {
+    constructor(status: number, message: string, code?: string);
+}
+/** 409 from `PUT /schema/sources/:id`: a name this source declares is owned by core, a bundle, or another source. */
+declare class SchemaSourceConflictError extends StandardsRequestError {
+    /** The object or `object:view` name that clashed. */
+    readonly objectName: string;
+    /** `core`, `bundle:<id>` or `source:<id>`. */
+    readonly owner: string;
+    constructor(status: number, message: string, code: string | undefined);
+}
+/** 400 from `PUT /schema/sources/:id`: bad id, oversize payload, hash mismatch, invalid definition, or an unresolved migration. */
+declare class SchemaSourceValidationError extends StandardsRequestError {
+    constructor(status: number, message: string, code: string | undefined);
+}
+/** The client was constructed in a way it refuses to run (e.g. an API key in a browser). */
+declare class StandardsConfigurationError extends Error {
+    constructor(message: string);
+}
+
+export { type FetchResult, type ObjectBuilderLike, type RecordInput, type RecordUpdate, type RecordsQuery, type SchemaSource, SchemaSourceConflictError, type SchemaSourceSummary, SchemaSourceValidationError, type Standards, StandardsAuthError, StandardsConfigurationError, StandardsRequestError, type SyncResult, type Transport, type TransportConfig, type UntypedBuilder, type UntypedRecordsQuery, createRecordsQuery, createStandards, createTransport, defineSchemaSource, hashSchemaSource, reviveRecord, syncSchemaSource };

package/dist/index.js

@@ -0,0 +1,2 @@
+'use strict';var schema=require('@stndrds/schema'),crypto=require('crypto');/*! © 2025-2026 AND YOU CREATE SAS (RCS Paris 940 190 614). Proprietary — see LICENSE (Standards SDK License 1.0). */
+var V=Object.defineProperty;var n=(r,e)=>V(r,"name",{value:e,configurable:true});var c=class extends Error{static{n(this,"StandardsRequestError");}constructor(e,t,i){super(t),this.name="StandardsRequestError",this.status=e,this.code=i;}},f=class extends c{static{n(this,"StandardsAuthError");}constructor(e,t,i){super(e,t,i),this.name="StandardsAuthError";}},T=class extends c{static{n(this,"SchemaSourceConflictError");}constructor(e,t,i){super(e,t,i),this.name="SchemaSourceConflictError";let o=/"([^"]+)" is owned by (\S+)/.exec(t);this.objectName=o?.[1]??"",this.owner=o?.[2]??"";}},R=class extends c{static{n(this,"SchemaSourceValidationError");}constructor(e,t,i){super(e,t,i),this.name="SchemaSourceValidationError";}},g=class extends Error{static{n(this,"StandardsConfigurationError");}constructor(e){super(e),this.name="StandardsConfigurationError";}};var C=["createdAt","updatedAt","deletedAt"];function D(r){let e=new Set;for(let t of r?.attributes??[])t.type==="date"&&e.add(t.name);return e}n(D,"dateAttributeNames");function I(r){return typeof r=="object"&&r!==null&&"start"in r&&"end"in r}n(I,"isRange");function U(r){return typeof r=="object"&&r!==null&&!Array.isArray(r)}n(U,"isRecord");function _(r){let{values:e,...t}=r;return {...t,...U(e)?e:{}}}n(_,"flattenValues");function S(r){return typeof r=="string"?new Date(r):I(r)?{start:S(r.start),end:S(r.end)}:r}n(S,"toDate");function k(r,e){let t=D(r),i=_(e);for(let o of C)o in i&&(i[o]=S(i[o]));for(let o of t)o in i&&(i[o]=S(i[o]));return i}n(k,"reviveRecord");function E(r){return Object.fromEntries(Object.entries(r).map(([e,t])=>[e,t instanceof Date?t.toISOString():t]))}n(E,"serializeInput");function b(r,...e){return ["/records",...[r,...e].map(F)].join("/")}n(b,"recordsPath");function F(r){if(r===""||r==="."||r==="..")throw new schema.ValidationError(`Invalid path segment "${r}" in a records request`,[]);return encodeURIComponent(r)}n(F,"encodePathSegment");var B=class r{constructor(e,t,i,o={combinator:"and",rules:[],sorts:[]}){this.transport=e;this.objectName=t;this.definition=i;this.state=o;}static{n(this,"RecordsQueryImpl");}with(e){return new r(this.transport,this.objectName,this.definition,{...this.state,...e})}rule(e,t,i){return this.with({rules:[...this.state.rules,{attribute:e,operator:t,value:i}]})}eq(e,t){return this.rule(e,"is",t)}neq(e,t){return this.rule(e,"is_not",t)}gt(e,t){return this.rule(e,"greater_than",t)}gte(e,t){return this.rule(e,"greater_or_equal",t)}lt(e,t){return this.rule(e,"less_than",t)}lte(e,t){return this.rule(e,"less_or_equal",t)}contains(e,t){return this.rule(e,"contains",t)}notContains(e,t){return this.rule(e,"not_contains",t)}startsWith(e,t){return this.rule(e,"starts_with",t)}endsWith(e,t){return this.rule(e,"ends_with",t)}in(e,t){return this.rule(e,"any_of",t)}notIn(e,t){return this.rule(e,"none_of",t)}isEmpty(e){return this.rule(e,"is_empty",null)}isNotEmpty(e){return this.rule(e,"is_not_empty",null)}or(){return this.with({combinator:"or"})}orderBy(e,t="asc"){return this.with({sorts:[...this.state.sorts,{attribute:e,direction:t}]})}limit(e){return this.with({limit:e})}offset(e){return this.with({offset:e})}search(e){return this.with({search:e})}body(){let e={};return this.state.search!==void 0&&(e.q=this.state.search),this.state.rules.length>0&&(e.filters={combinator:this.state.combinator,rules:this.state.rules}),this.state.sorts.length>0&&(e.sorts=this.state.sorts),this.state.limit!==void 0&&(e.limit=this.state.limit),this.state.offset!==void 0&&(e.offset=this.state.offset),e}revive(e){return k(this.definition,e)}async fetch(){let e=this.state.search!==void 0?"search":"list",t=await this.transport.post(b(this.objectName,e),this.body());return {records:t.data.map(i=>this.revive(i)),total:t.page.total}}async single(){let{records:e}=await this.limit(1).fetch();return e[0]??null}async get(e){let t=await this.transport.get(b(this.objectName,e));return this.revive(t)}async create(e){let t=await this.transport.post(b(this.objectName),{data:E(e)});return this.revive(t)}async update(e,t){let i=await this.transport.put(b(this.objectName,e),E(t));return this.revive(i)}async delete(e){await this.transport.delete(b(this.objectName,e));}};function x(r,e){if(typeof e=="string")return new B(r,e,null);let t=e.build();return new B(r,t.name,t)}n(x,"createRecordsQuery");async function j(r,e){let t=`/schema/sources/${encodeURIComponent(e.id)}`,i;try{i=await r.get(t);}catch(o){if(o instanceof c&&o.status===404)i=null;else throw o}if(i?.hash===e.hash)return {applied:false,hash:e.hash};try{return await r.put(t,{hash:e.hash,objects:e.objects,views:e.views})}catch(o){throw o instanceof c&&o.status===409?new T(o.status,o.message,o.code):o instanceof c&&o.status===400?new R(o.status,o.message,o.code):o}}n(j,"syncSchemaSource");function A(r,e,t){let i=r.endsWith("/")?r:`${r}/`,o=e.replace(/^\/+/,""),l=new URL(o,i);if(t)for(let[w,h]of Object.entries(t))h!=null&&l.searchParams.set(w,String(h));return l.toString()}n(A,"buildUrl");function O(r){let{baseUrl:e,apiKey:t,tenantId:i,timeoutMs:o=3e4}=r,l={Authorization:`Bearer ${t}`,"Content-Type":"application/json",...i?{"X-Tenant-ID":i}:{}};async function w(u,a){try{return await fetch(u,{...a,signal:AbortSignal.timeout(o)})}catch(s){throw s instanceof TypeError||s instanceof DOMException&&s.name==="TimeoutError"?new c(0,`Could not connect to ${e}`):s}}n(w,"fetchOrThrow");async function h(u,a){let s=await w(u,a);if(s.status===204)return null;let d=await s.json();if(!s.ok){let p=d,m=p.message??`Request failed with status ${s.status}`;throw s.status===401||s.status===403?new f(s.status,m,p.code):new c(s.status,m,p.code)}return d}n(h,"sendRequest");function y(u,a,s){let d=A(e,a,s?.params);return h(d,{method:u,headers:l,body:s?.body?JSON.stringify(s.body):void 0})}n(y,"request");async function v(u,a){let s=A(e,u,a),d=await w(s,{method:"GET",headers:l}),p=await d.text();if(!d.ok){let m=`Request failed with status ${d.status}`;try{m=JSON.parse(p).message??m;}catch{p&&(m=p);}throw d.status===401||d.status===403?new f(d.status,m):new c(d.status,m)}return p}n(v,"getText");function Q(u,a){let s=A(e,u),{"Content-Type":d,...p}=l;return h(s,{method:"POST",headers:p,body:a})}return n(Q,"postMultipart"),{get(u,a){return y("GET",u,{params:a})},post(u,a){return y("POST",u,{body:a})},patch(u,a){return y("PATCH",u,{body:a})},put(u,a){return y("PUT",u,{body:a})},delete(u){return y("DELETE",u)},getText:v,postMultipart:Q}}n(O,"createTransport");function N(r){if(typeof globalThis.window<"u"&&r.apiKey)throw new g("createStandards received an apiKey in a browser context. API keys belong to server code only (Route Handlers, Server Components, scripts).");let e=O(r);return {schema:{sync:n(t=>j(e,t),"sync")},from:n((t=>typeof t=="string"?x(e,t):x(e,t)),"from")}}n(N,"createStandards");function H(r){return "build"in r&&typeof r.build=="function"?r.build():r}n(H,"buildView");function P(r){return crypto.createHash("sha256").update(schema.canonicalStringify(r)).digest("hex")}n(P,"hashSchemaSource");function K(r,e){schema.assertSchemaSourceId(r);let t=e.objects.map(l=>l.build()),i=new Set;for(let l of t){if(i.has(l.name))throw new schema.DuplicateError("object",l.name);i.add(l.name);}let o=(e.views??[]).map(H);return {id:r,hash:P({objects:t,views:o}),objects:t,views:o,builders:e.objects}}n(K,"defineSchemaSource");Object.defineProperty(exports,"DuplicateError",{enumerable:true,get:function(){return schema.DuplicateError}});Object.defineProperty(exports,"ForbiddenError",{enumerable:true,get:function(){return schema.ForbiddenError}});Object.defineProperty(exports,"NotFoundError",{enumerable:true,get:function(){return schema.NotFoundError}});Object.defineProperty(exports,"SCHEMA_SOURCE_ID_PATTERN",{enumerable:true,get:function(){return schema.SCHEMA_SOURCE_ID_PATTERN}});Object.defineProperty(exports,"SchemaError",{enumerable:true,get:function(){return schema.SchemaError}});Object.defineProperty(exports,"SchemaErrorCode",{enumerable:true,get:function(){return schema.SchemaErrorCode}});Object.defineProperty(exports,"ValidationError",{enumerable:true,get:function(){return schema.ValidationError}});Object.defineProperty(exports,"assertSchemaSourceId",{enumerable:true,get:function(){return schema.assertSchemaSourceId}});Object.defineProperty(exports,"canonicalStringify",{enumerable:true,get:function(){return schema.canonicalStringify}});Object.defineProperty(exports,"checkbox",{enumerable:true,get:function(){return schema.checkbox}});Object.defineProperty(exports,"currency",{enumerable:true,get:function(){return schema.currency}});Object.defineProperty(exports,"date",{enumerable:true,get:function(){return schema.date}});Object.defineProperty(exports,"detailView",{enumerable:true,get:function(){return schema.detailView}});Object.defineProperty(exports,"document",{enumerable:true,get:function(){return schema.document}});Object.defineProperty(exports,"formula",{enumerable:true,get:function(){return schema.formula}});Object.defineProperty(exports,"group",{enumerable:true,get:function(){return schema.group}});Object.defineProperty(exports,"listView",{enumerable:true,get:function(){return schema.listView}});Object.defineProperty(exports,"location",{enumerable:true,get:function(){return schema.location}});Object.defineProperty(exports,"multiselect",{enumerable:true,get:function(){return schema.multiselect}});Object.defineProperty(exports,"number",{enumerable:true,get:function(){return schema.number}});Object.defineProperty(exports,"object",{enumerable:true,get:function(){return schema.object}});Object.defineProperty(exports,"phone",{enumerable:true,get:function(){return schema.phone}});Object.defineProperty(exports,"relation",{enumerable:true,get:function(){return schema.relation}});Object.defineProperty(exports,"richtext",{enumerable:true,get:function(){return schema.richtext}});Object.defineProperty(exports,"rollup",{enumerable:true,get:function(){return schema.rollup}});Object.defineProperty(exports,"select",{enumerable:true,get:function(){return schema.select}});Object.defineProperty(exports,"status",{enumerable:true,get:function(){return schema.status}});Object.defineProperty(exports,"text",{enumerable:true,get:function(){return schema.text}});Object.defineProperty(exports,"user",{enumerable:true,get:function(){return schema.user}});exports.SchemaSourceConflictError=T;exports.SchemaSourceValidationError=R;exports.StandardsAuthError=f;exports.StandardsConfigurationError=g;exports.StandardsRequestError=c;exports.createRecordsQuery=x;exports.createStandards=N;exports.createTransport=O;exports.defineSchemaSource=K;exports.hashSchemaSource=P;exports.reviveRecord=k;exports.syncSchemaSource=j;

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import {ValidationError,canonicalStringify,assertSchemaSourceId,DuplicateError}from'@stndrds/schema';export{DuplicateError,ForbiddenError,NotFoundError,SCHEMA_SOURCE_ID_PATTERN,SchemaError,SchemaErrorCode,ValidationError,assertSchemaSourceId,canonicalStringify,checkbox,currency,date,detailView,document,formula,group,listView,location,multiselect,number,object,phone,relation,richtext,rollup,select,status,text,user}from'@stndrds/schema';import {createHash}from'crypto';/*! © 2025-2026 AND YOU CREATE SAS (RCS Paris 940 190 614). Proprietary — see LICENSE (Standards SDK License 1.0). */
+var V=Object.defineProperty;var n=(r,e)=>V(r,"name",{value:e,configurable:true});var c=class extends Error{static{n(this,"StandardsRequestError");}constructor(e,t,i){super(t),this.name="StandardsRequestError",this.status=e,this.code=i;}},f=class extends c{static{n(this,"StandardsAuthError");}constructor(e,t,i){super(e,t,i),this.name="StandardsAuthError";}},T=class extends c{static{n(this,"SchemaSourceConflictError");}constructor(e,t,i){super(e,t,i),this.name="SchemaSourceConflictError";let o=/"([^"]+)" is owned by (\S+)/.exec(t);this.objectName=o?.[1]??"",this.owner=o?.[2]??"";}},R=class extends c{static{n(this,"SchemaSourceValidationError");}constructor(e,t,i){super(e,t,i),this.name="SchemaSourceValidationError";}},g=class extends Error{static{n(this,"StandardsConfigurationError");}constructor(e){super(e),this.name="StandardsConfigurationError";}};var C=["createdAt","updatedAt","deletedAt"];function D(r){let e=new Set;for(let t of r?.attributes??[])t.type==="date"&&e.add(t.name);return e}n(D,"dateAttributeNames");function I(r){return typeof r=="object"&&r!==null&&"start"in r&&"end"in r}n(I,"isRange");function U(r){return typeof r=="object"&&r!==null&&!Array.isArray(r)}n(U,"isRecord");function _(r){let{values:e,...t}=r;return {...t,...U(e)?e:{}}}n(_,"flattenValues");function S(r){return typeof r=="string"?new Date(r):I(r)?{start:S(r.start),end:S(r.end)}:r}n(S,"toDate");function k(r,e){let t=D(r),i=_(e);for(let o of C)o in i&&(i[o]=S(i[o]));for(let o of t)o in i&&(i[o]=S(i[o]));return i}n(k,"reviveRecord");function E(r){return Object.fromEntries(Object.entries(r).map(([e,t])=>[e,t instanceof Date?t.toISOString():t]))}n(E,"serializeInput");function b(r,...e){return ["/records",...[r,...e].map(F)].join("/")}n(b,"recordsPath");function F(r){if(r===""||r==="."||r==="..")throw new ValidationError(`Invalid path segment "${r}" in a records request`,[]);return encodeURIComponent(r)}n(F,"encodePathSegment");var B=class r{constructor(e,t,i,o={combinator:"and",rules:[],sorts:[]}){this.transport=e;this.objectName=t;this.definition=i;this.state=o;}static{n(this,"RecordsQueryImpl");}with(e){return new r(this.transport,this.objectName,this.definition,{...this.state,...e})}rule(e,t,i){return this.with({rules:[...this.state.rules,{attribute:e,operator:t,value:i}]})}eq(e,t){return this.rule(e,"is",t)}neq(e,t){return this.rule(e,"is_not",t)}gt(e,t){return this.rule(e,"greater_than",t)}gte(e,t){return this.rule(e,"greater_or_equal",t)}lt(e,t){return this.rule(e,"less_than",t)}lte(e,t){return this.rule(e,"less_or_equal",t)}contains(e,t){return this.rule(e,"contains",t)}notContains(e,t){return this.rule(e,"not_contains",t)}startsWith(e,t){return this.rule(e,"starts_with",t)}endsWith(e,t){return this.rule(e,"ends_with",t)}in(e,t){return this.rule(e,"any_of",t)}notIn(e,t){return this.rule(e,"none_of",t)}isEmpty(e){return this.rule(e,"is_empty",null)}isNotEmpty(e){return this.rule(e,"is_not_empty",null)}or(){return this.with({combinator:"or"})}orderBy(e,t="asc"){return this.with({sorts:[...this.state.sorts,{attribute:e,direction:t}]})}limit(e){return this.with({limit:e})}offset(e){return this.with({offset:e})}search(e){return this.with({search:e})}body(){let e={};return this.state.search!==void 0&&(e.q=this.state.search),this.state.rules.length>0&&(e.filters={combinator:this.state.combinator,rules:this.state.rules}),this.state.sorts.length>0&&(e.sorts=this.state.sorts),this.state.limit!==void 0&&(e.limit=this.state.limit),this.state.offset!==void 0&&(e.offset=this.state.offset),e}revive(e){return k(this.definition,e)}async fetch(){let e=this.state.search!==void 0?"search":"list",t=await this.transport.post(b(this.objectName,e),this.body());return {records:t.data.map(i=>this.revive(i)),total:t.page.total}}async single(){let{records:e}=await this.limit(1).fetch();return e[0]??null}async get(e){let t=await this.transport.get(b(this.objectName,e));return this.revive(t)}async create(e){let t=await this.transport.post(b(this.objectName),{data:E(e)});return this.revive(t)}async update(e,t){let i=await this.transport.put(b(this.objectName,e),E(t));return this.revive(i)}async delete(e){await this.transport.delete(b(this.objectName,e));}};function x(r,e){if(typeof e=="string")return new B(r,e,null);let t=e.build();return new B(r,t.name,t)}n(x,"createRecordsQuery");async function j(r,e){let t=`/schema/sources/${encodeURIComponent(e.id)}`,i;try{i=await r.get(t);}catch(o){if(o instanceof c&&o.status===404)i=null;else throw o}if(i?.hash===e.hash)return {applied:false,hash:e.hash};try{return await r.put(t,{hash:e.hash,objects:e.objects,views:e.views})}catch(o){throw o instanceof c&&o.status===409?new T(o.status,o.message,o.code):o instanceof c&&o.status===400?new R(o.status,o.message,o.code):o}}n(j,"syncSchemaSource");function A(r,e,t){let i=r.endsWith("/")?r:`${r}/`,o=e.replace(/^\/+/,""),l=new URL(o,i);if(t)for(let[w,h]of Object.entries(t))h!=null&&l.searchParams.set(w,String(h));return l.toString()}n(A,"buildUrl");function O(r){let{baseUrl:e,apiKey:t,tenantId:i,timeoutMs:o=3e4}=r,l={Authorization:`Bearer ${t}`,"Content-Type":"application/json",...i?{"X-Tenant-ID":i}:{}};async function w(u,a){try{return await fetch(u,{...a,signal:AbortSignal.timeout(o)})}catch(s){throw s instanceof TypeError||s instanceof DOMException&&s.name==="TimeoutError"?new c(0,`Could not connect to ${e}`):s}}n(w,"fetchOrThrow");async function h(u,a){let s=await w(u,a);if(s.status===204)return null;let d=await s.json();if(!s.ok){let p=d,m=p.message??`Request failed with status ${s.status}`;throw s.status===401||s.status===403?new f(s.status,m,p.code):new c(s.status,m,p.code)}return d}n(h,"sendRequest");function y(u,a,s){let d=A(e,a,s?.params);return h(d,{method:u,headers:l,body:s?.body?JSON.stringify(s.body):void 0})}n(y,"request");async function v(u,a){let s=A(e,u,a),d=await w(s,{method:"GET",headers:l}),p=await d.text();if(!d.ok){let m=`Request failed with status ${d.status}`;try{m=JSON.parse(p).message??m;}catch{p&&(m=p);}throw d.status===401||d.status===403?new f(d.status,m):new c(d.status,m)}return p}n(v,"getText");function Q(u,a){let s=A(e,u),{"Content-Type":d,...p}=l;return h(s,{method:"POST",headers:p,body:a})}return n(Q,"postMultipart"),{get(u,a){return y("GET",u,{params:a})},post(u,a){return y("POST",u,{body:a})},patch(u,a){return y("PATCH",u,{body:a})},put(u,a){return y("PUT",u,{body:a})},delete(u){return y("DELETE",u)},getText:v,postMultipart:Q}}n(O,"createTransport");function N(r){if(typeof globalThis.window<"u"&&r.apiKey)throw new g("createStandards received an apiKey in a browser context. API keys belong to server code only (Route Handlers, Server Components, scripts).");let e=O(r);return {schema:{sync:n(t=>j(e,t),"sync")},from:n((t=>typeof t=="string"?x(e,t):x(e,t)),"from")}}n(N,"createStandards");function H(r){return "build"in r&&typeof r.build=="function"?r.build():r}n(H,"buildView");function P(r){return createHash("sha256").update(canonicalStringify(r)).digest("hex")}n(P,"hashSchemaSource");function K(r,e){assertSchemaSourceId(r);let t=e.objects.map(l=>l.build()),i=new Set;for(let l of t){if(i.has(l.name))throw new DuplicateError("object",l.name);i.add(l.name);}let o=(e.views??[]).map(H);return {id:r,hash:P({objects:t,views:o}),objects:t,views:o,builders:e.objects}}n(K,"defineSchemaSource");export{T as SchemaSourceConflictError,R as SchemaSourceValidationError,f as StandardsAuthError,g as StandardsConfigurationError,c as StandardsRequestError,x as createRecordsQuery,N as createStandards,O as createTransport,K as defineSchemaSource,P as hashSchemaSource,k as reviveRecord,j as syncSchemaSource};

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@stndrds/client",
+  "version": "1.0.0-alpha.295",
+  "description": "Public TypeScript client for Standards: declare schema sources with the fluent builders, sync them to a hosted tenant, and operate typed records over the REST API.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "dependencies": {
+    "@stndrds/schema": "1.0.0-alpha.295"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.6.3",
+    "vitest": "^4.1.11"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/andyoucreate/standards.git",
+    "directory": "packages/client"
+  },
+  "license": "SEE LICENSE IN LICENSE",
+  "author": "AndYouCreate",
+  "homepage": "https://docs.standards.new",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "biome check .",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "typecheck:tests": "tsc --noEmit -p tsconfig.test.json",
+    "clean": "rm -rf dist"
+  }
+}