@notambourine/metafields 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Not a Tambourine
+
+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/README.md

@@ -0,0 +1,96 @@
+# @notambourine/metafields
+
+Declare merchant-owned Shopify metafield and metaobject definitions in TypeScript, inspect drift,
+and create only what is missing. The CLI never updates or deletes definitions during schema sync.
+
+```ts
+import { defineSchema, field, metaobject } from '@notambourine/metafields';
+
+export default defineSchema({
+  metaobjects: {
+    faq: metaobject({
+      name: 'FAQ',
+      displayNameKey: 'question',
+      fields: {
+        question: field.string({ name: 'Question', required: true }),
+        answer: field.richText({ name: 'Answer', required: true }),
+      },
+    }),
+  },
+  metafields: {
+    product: {
+      custom: {
+        promo_text: field.string({ name: 'Promo text' }),
+        faq: field.metaobject('faq', { name: 'FAQ' }),
+      },
+    },
+  },
+});
+```
+
+```sh
+npx @notambourine/metafields ./schema.ts --validate
+npx @notambourine/metafields ./schema.ts --store example.myshopify.com
+npx @notambourine/metafields ./schema.ts --store example.myshopify.com --apply
+npx @notambourine/metafields ./schema.ts --store example.myshopify.com --check
+```
+
+Store operations read `SHOPIFY_ADMIN_ACCESS_TOKEN`. The default command is a dry run. Importing a
+TypeScript schema executes trusted local code, so compile declarations to canonical JSON before a
+secret-bearing workflow consumes pull-request output.
+
+Schema modules use Node's built-in type stripping and must use erasable TypeScript syntax.
+
+See `metafields --help` for `pull`, `compile`, and migration commands.
+
+## Behavior
+
+- Dry run reports missing definitions without writing them.
+- `--apply` creates missing metaobject definitions in dependency order, then metafield definitions.
+- `--check` exits nonzero for missing or incompatible operational shape.
+- Cosmetic name and description drift is reported but never changed.
+- Existing definitions, values, and entries are never updated or deleted by schema sync.
+
+Exit `0` means the selected condition is satisfied, exit `1` means schema or migration drift, and
+exit `2` means invalid input, indeterminate Shopify state, or an API failure.
+
+`pull` requires explicit owners and namespaces:
+
+```sh
+metafields pull --store example.myshopify.com \
+  --owner product --namespace custom --metaobjects --out schema.ts
+```
+
+The output path must not exist. Without `--out`, the generated module is written to stdout.
+
+## Migrations
+
+Migrations are declarative, copy-only, and compiled before credentials are introduced:
+
+```ts
+import { defineMigration, transforms } from '@notambourine/metafields';
+import schema from './schema.js';
+
+export default defineMigration({
+  id: 'product-internet-url-v1',
+  from: schema.metafields.product.custom.internet,
+  to: schema.metafields.product.custom.internet_url,
+  mode: 'copy',
+  transform: transforms.url({
+    allowedSchemes: ['http', 'https'],
+    bareHost: 'reject',
+    trim: true,
+  }),
+  onInvalid: 'fail',
+  onTargetConflict: 'fail',
+});
+```
+
+```sh
+metafields compile ./migration.ts --out ./migration.json
+metafields migrate ./migration.json --store example.myshopify.com
+metafields migrate ./migration.json --store example.myshopify.com --apply
+```
+
+`0.0.x` is prerelease quality. Confirm owner scopes and behavior against a development store before
+production use.

package/dist/admin.d.ts

@@ -0,0 +1,34 @@
+import type { CanonicalMetafield, CanonicalMetaobject, CompiledSchema } from './schema.js';
+import type { ExistingMetafield, ExistingMetaobject, ExistingSchema, Plan } from './planner.js';
+export declare const DEFAULT_API_VERSION = "2026-07";
+export declare class AdminError extends Error {
+    readonly requestId?: string;
+    constructor(message: string, requestId?: string);
+}
+export interface AdminClientOptions {
+    store: string;
+    token: string;
+    apiVersion?: string;
+    timeoutMs?: number;
+    retries?: number;
+    fetch?: typeof globalThis.fetch;
+}
+export declare class AdminClient {
+    #private;
+    readonly store: string;
+    readonly apiVersion: string;
+    readonly endpoint: string;
+    constructor(options: AdminClientOptions);
+    request<T>(query: string, variables?: Record<string, unknown>, mutation?: boolean): Promise<T>;
+    readSchema(schema: CompiledSchema): Promise<ExistingSchema>;
+    readMetaobject(type: string): Promise<ExistingMetaobject | null>;
+    readMetafield(definition: Pick<CanonicalMetafield, 'ownerType' | 'namespace' | 'key'>): Promise<ExistingMetafield | null>;
+    createMetaobject(definition: CanonicalMetaobject): Promise<void>;
+    createMetafield(definition: CanonicalMetafield): Promise<void>;
+}
+export interface ApplyResult {
+    plan: Plan;
+    applied: string[];
+}
+export declare function synchronize(client: AdminClient, schema: CompiledSchema, mode: 'dry-run' | 'check' | 'apply'): Promise<ApplyResult>;
+//# sourceMappingURL=admin.d.ts.map

package/dist/admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../src/admin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAGhG,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAE7C,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEhB,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAKhD;AAQD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAED,qBAAa,WAAW;;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAMd,OAAO,EAAE,kBAAkB;IAmBjC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAAE,QAAQ,UAAQ,GAAG,OAAO,CAAC,CAAC,CAAC;IA2ChG,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAc3D,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAQhE,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,GAAG,WAAW,GAAG,KAAK,CAAC,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IASzH,gBAAgB,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhE,eAAe,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;CASrE;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,GAClC,OAAO,CAAC,WAAW,CAAC,CAsBtB"}

package/dist/admin.js

@@ -0,0 +1,303 @@
+import { exitCodeForPlan, planSchema } from './planner.js';
+export const DEFAULT_API_VERSION = '2026-07';
+export class AdminError extends Error {
+    requestId;
+    constructor(message, requestId) {
+        super(message);
+        this.name = 'AdminError';
+        if (requestId !== undefined)
+            this.requestId = requestId;
+    }
+}
+export class AdminClient {
+    store;
+    apiVersion;
+    endpoint;
+    #token;
+    #timeoutMs;
+    #retries;
+    #fetch;
+    constructor(options) {
+        const store = options.store.toLowerCase();
+        if (!/^[a-z0-9][a-z0-9-]*\.myshopify\.com$/.test(store)) {
+            throw new AdminError('store must be a *.myshopify.com host');
+        }
+        const apiVersion = options.apiVersion ?? DEFAULT_API_VERSION;
+        if (!/^20\d{2}-(01|04|07|10)$/.test(apiVersion)) {
+            throw new AdminError('API version must use YYYY-01, YYYY-04, YYYY-07, or YYYY-10');
+        }
+        if (options.token.length === 0)
+            throw new AdminError('SHOPIFY_ADMIN_ACCESS_TOKEN is required');
+        this.store = store;
+        this.apiVersion = apiVersion;
+        this.endpoint = `https://${store}/admin/api/${apiVersion}/graphql.json`;
+        this.#token = options.token;
+        this.#timeoutMs = options.timeoutMs ?? 20_000;
+        this.#retries = options.retries ?? 3;
+        this.#fetch = options.fetch ?? globalThis.fetch;
+    }
+    async request(query, variables = {}, mutation = false) {
+        const attempts = mutation ? 1 : this.#retries + 1;
+        let lastError;
+        for (let attempt = 0; attempt < attempts; attempt += 1) {
+            try {
+                const response = await this.#fetch(this.endpoint, {
+                    method: 'POST',
+                    headers: {
+                        'content-type': 'application/json',
+                        'x-shopify-access-token': this.#token,
+                    },
+                    body: JSON.stringify({ query, variables }),
+                    signal: AbortSignal.timeout(this.#timeoutMs),
+                });
+                const requestId = response.headers.get('x-request-id') ?? undefined;
+                if (!response.ok) {
+                    const retryable = response.status === 429 || response.status >= 500;
+                    if (retryable && attempt + 1 < attempts) {
+                        await delay(backoff(attempt, response.headers.get('retry-after')));
+                        continue;
+                    }
+                    throw new AdminError(`Shopify Admin API returned HTTP ${response.status}`, requestId);
+                }
+                const envelope = await response.json();
+                if (envelope.errors?.length) {
+                    const throttled = envelope.errors.some((error) => /throttled/i.test(error.message));
+                    if (throttled && attempt + 1 < attempts) {
+                        await delay(backoff(attempt));
+                        continue;
+                    }
+                    throw new AdminError(`Shopify GraphQL error: ${envelope.errors.map((error) => error.message).join('; ')}`, requestId);
+                }
+                if (envelope.data === undefined)
+                    throw new AdminError('Shopify response contained no data', requestId);
+                return envelope.data;
+            }
+            catch (error) {
+                lastError = error;
+                if (error instanceof AdminError || attempt + 1 >= attempts)
+                    throw redactError(error);
+                await delay(backoff(attempt));
+            }
+        }
+        throw redactError(lastError);
+    }
+    async readSchema(schema) {
+        const metaobjects = [];
+        const metafields = [];
+        for (const definition of schema.metaobjects) {
+            const result = await this.readMetaobject(definition.type);
+            if (result)
+                metaobjects.push(result);
+        }
+        for (const definition of schema.metafields) {
+            const result = await this.readMetafield(definition);
+            if (result)
+                metafields.push(result);
+        }
+        return { metaobjects, metafields };
+    }
+    async readMetaobject(type) {
+        const data = await this.request(METAOBJECT_QUERY, { type });
+        return data.metaobjectDefinitionByType ? mapMetaobject(data.metaobjectDefinitionByType) : null;
+    }
+    async readMetafield(definition) {
+        const data = await this.request(METAFIELD_QUERY, {
+            ownerType: definition.ownerType,
+            namespace: definition.namespace,
+            key: definition.key,
+        });
+        return data.metafieldDefinition ? mapMetafield(data.metafieldDefinition) : null;
+    }
+    async createMetaobject(definition) {
+        const data = await this.request(METAOBJECT_CREATE, { definition: metaobjectCreateInput(definition) }, true);
+        assertMutation(data.metaobjectDefinitionCreate, `metaobject:${definition.type}`);
+    }
+    async createMetafield(definition) {
+        const data = await this.request(METAFIELD_CREATE, { definition: metafieldCreateInput(definition) }, true);
+        assertMutation({
+            created: data.metafieldDefinitionCreate.createdDefinition,
+            userErrors: data.metafieldDefinitionCreate.userErrors,
+        }, `metafield:${definition.ownerType}:${definition.namespace}.${definition.key}`);
+    }
+}
+export async function synchronize(client, schema, mode) {
+    const before = planSchema(schema, await client.readSchema(schema));
+    if (mode !== 'apply' || exitCodeForPlan(before, mode) !== 0)
+        return { plan: before, applied: [] };
+    const applied = [];
+    try {
+        for (const item of before.items.filter((value) => value.kind === 'metaobject' && value.status === 'CREATE')) {
+            await client.createMetaobject(item.desired);
+            applied.push(item.identity);
+        }
+        for (const item of before.items.filter((value) => value.kind === 'metafield' && value.status === 'CREATE')) {
+            await client.createMetafield(item.desired);
+            applied.push(item.identity);
+        }
+    }
+    catch (error) {
+        const landed = applied.length > 0 ? `; created before failure: ${applied.join(', ')}` : '';
+        throw new AdminError(`${error instanceof Error ? error.message : String(error)}${landed}`);
+    }
+    const after = planSchema(schema, await client.readSchema(schema));
+    if (exitCodeForPlan(after, 'check') !== 0) {
+        throw new AdminError(`post-apply verification failed; created: ${applied.join(', ') || 'none'}`);
+    }
+    return { plan: after, applied };
+}
+function assertMutation(payload, identity) {
+    if (payload.userErrors.length > 0) {
+        throw new AdminError(`${identity}: ${payload.userErrors.map((error) => error.message).join('; ')}`);
+    }
+    if (payload.metaobjectDefinition == null && payload.created == null) {
+        throw new AdminError(`${identity}: Shopify returned no created definition`);
+    }
+}
+function metafieldCreateInput(definition) {
+    const input = {
+        name: definition.name,
+        namespace: definition.namespace,
+        key: definition.key,
+        ownerType: definition.ownerType,
+        type: definition.type,
+    };
+    if (definition.description !== undefined)
+        input.description = definition.description;
+    if (definition.validations.length > 0)
+        input.validations = definition.validations;
+    if (definition.access)
+        input.access = definition.access;
+    if (definition.capabilities)
+        input.capabilities = capabilityInput(definition.capabilities);
+    if (definition.constraints)
+        input.constraints = definition.constraints;
+    return input;
+}
+function metaobjectCreateInput(definition) {
+    const input = {
+        type: definition.type,
+        name: definition.name,
+        fieldDefinitions: definition.fields.map((field) => {
+            const result = { key: field.key, name: field.name, type: field.type };
+            if (field.description !== undefined)
+                result.description = field.description;
+            if (field.required !== undefined)
+                result.required = field.required;
+            if (field.validations.length > 0)
+                result.validations = field.validations;
+            return result;
+        }),
+    };
+    if (definition.description !== undefined)
+        input.description = definition.description;
+    if (definition.displayNameKey !== undefined)
+        input.displayNameKey = definition.displayNameKey;
+    if (definition.access)
+        input.access = definition.access;
+    if (definition.capabilities)
+        input.capabilities = capabilityInput(definition.capabilities);
+    return input;
+}
+function capabilityInput(capabilities) {
+    return Object.fromEntries(Object.entries(capabilities).map(([key, enabled]) => [key, { enabled }]));
+}
+function mapField(field) {
+    return {
+        key: field.key,
+        name: field.name,
+        description: field.description,
+        type: field.type,
+        required: field.required,
+        validations: field.validations,
+    };
+}
+function mapMetaobject(value) {
+    return {
+        id: value.id,
+        type: value.type,
+        name: value.name,
+        description: value.description,
+        displayNameKey: value.displayNameKey,
+        access: value.access,
+        capabilities: {
+            publishable: value.capabilities.publishable.enabled,
+            translatable: value.capabilities.translatable.enabled,
+        },
+        fields: value.fieldDefinitions.map(mapField),
+    };
+}
+function mapMetafield(value) {
+    return {
+        ...mapField(value),
+        id: value.id,
+        namespace: value.namespace,
+        ownerType: value.ownerType,
+        access: value.access,
+        capabilities: Object.fromEntries(Object.entries(value.capabilities).map(([key, item]) => [key, item.enabled])),
+        constraints: value.constraints
+            ? { key: value.constraints.key, values: value.constraints.values.nodes.map((item) => item.value) }
+            : null,
+        validationStatus: value.validationStatus,
+        invalidCount: value.invalidCount,
+    };
+}
+function redactError(error) {
+    if (error instanceof AdminError)
+        return error;
+    const message = error instanceof Error ? error.message : String(error);
+    return new AdminError(message.replace(/shpat_[A-Za-z0-9_-]+/g, '[REDACTED]'));
+}
+function backoff(attempt, retryAfter) {
+    const seconds = retryAfter === undefined || retryAfter === null ? Number.NaN : Number(retryAfter);
+    if (Number.isFinite(seconds))
+        return Math.min(seconds * 1000, 10_000);
+    return Math.min(250 * 2 ** attempt, 4_000);
+}
+function delay(milliseconds) {
+    return new Promise((resolve) => setTimeout(resolve, milliseconds));
+}
+const FIELD_SELECTION = `
+  key name description type { name } required validations { name value }
+`;
+const METAOBJECT_QUERY = `
+query MetaobjectDefinition($type: String!) {
+  metaobjectDefinitionByType(type: $type) {
+    id type name description displayNameKey
+    access { admin storefront }
+    capabilities { publishable { enabled } translatable { enabled } }
+    fieldDefinitions { ${FIELD_SELECTION} }
+  }
+}`;
+const METAFIELD_QUERY = `
+query MetafieldDefinition($ownerType: MetafieldOwnerType!, $namespace: String!, $key: String!) {
+  metafieldDefinition(ownerType: $ownerType, namespace: $namespace, key: $key) {
+    id namespace key ownerType name description type { name }
+    validations { name value }
+    access { admin storefront customerAccount }
+    capabilities {
+      adminFilterable { enabled }
+      analyticsQueryable { enabled }
+      cartToOrderCopyable { enabled }
+      smartCollectionCondition { enabled }
+      uniqueValues { enabled }
+    }
+    constraints { key values(first: 250) { nodes { value } } }
+    validationStatus
+    invalidCount: metafieldsCount(validationStatus: INVALID)
+  }
+}`;
+const METAOBJECT_CREATE = `
+mutation CreateMetaobjectDefinition($definition: MetaobjectDefinitionCreateInput!) {
+  metaobjectDefinitionCreate(definition: $definition) {
+    metaobjectDefinition { id }
+    userErrors { field message code }
+  }
+}`;
+const METAFIELD_CREATE = `
+mutation CreateMetafieldDefinition($definition: MetafieldDefinitionInput!) {
+  metafieldDefinitionCreate(definition: $definition) {
+    createdDefinition { id }
+    userErrors { field message code }
+  }
+}`;
+//# sourceMappingURL=admin.js.map

package/dist/admin.js.map

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

package/dist/builders.d.ts

@@ -0,0 +1,28 @@
+import { type CollectionReference, type Decimal, type FieldDefinition, type FieldOptions, type Fields, type FileReference, type JsonOptions, type ListOptions, type MetaobjectDefinition, type MetaobjectOptions, type MetaobjectReference, type Metafields, type Metaobjects, type NumberOptions, type ProductReference, type RichText, type SchemaDefinition, type TextOptions, type Url, type ValidMetafields, type ValidMetaobjects, type VariantReference } from './types.js';
+type RequiredFlag<O> = O extends {
+    readonly required: true;
+} ? true : false;
+export declare const field: {
+    string<const O extends TextOptions = {}>(options?: O): FieldDefinition<string, RequiredFlag<O>, never>;
+    text<const O extends TextOptions = {}>(options?: O): FieldDefinition<string, RequiredFlag<O>, never>;
+    richText<const O extends FieldOptions = {}>(options?: O): FieldDefinition<RichText, RequiredFlag<O>, never>;
+    integer<const O extends NumberOptions = {}>(options?: O): FieldDefinition<number, RequiredFlag<O>, never>;
+    decimal<const O extends NumberOptions = {}>(options?: O): FieldDefinition<Decimal, RequiredFlag<O>, never>;
+    boolean<const O extends FieldOptions = {}>(options?: O): FieldDefinition<boolean, RequiredFlag<O>, never>;
+    url<const O extends FieldOptions = {}>(options?: O): FieldDefinition<Url, RequiredFlag<O>, never>;
+    json<Value = unknown, const O extends JsonOptions = JsonOptions>(options?: O): FieldDefinition<Value, RequiredFlag<O>, never>;
+    product<const O extends FieldOptions = {}>(options?: O): FieldDefinition<ProductReference, RequiredFlag<O>, never>;
+    variant<const O extends FieldOptions = {}>(options?: O): FieldDefinition<VariantReference, RequiredFlag<O>, never>;
+    collection<const O extends FieldOptions = {}>(options?: O): FieldDefinition<CollectionReference, RequiredFlag<O>, never>;
+    file<const O extends FieldOptions = {}>(options?: O): FieldDefinition<FileReference, RequiredFlag<O>, never>;
+    metaobject<const Key extends string, const O extends FieldOptions = {}>(key: Key, options?: O): FieldDefinition<MetaobjectReference<Key>, RequiredFlag<O>, Key>;
+    mixedMetaobject<const Keys extends readonly [string, ...string[]], const O extends FieldOptions = {}>(keys: Keys, options?: O): FieldDefinition<MetaobjectReference<Keys[number]>, RequiredFlag<O>, Keys[number]>;
+    list<Value, InnerRequired extends boolean, Targets extends string, const O extends ListOptions = {}>(inner: FieldDefinition<Value, InnerRequired, Targets>, options?: O): FieldDefinition<Value[], RequiredFlag<O>, Targets>;
+};
+export declare function metaobject<const F extends Fields>(definition: MetaobjectOptions<F>): MetaobjectDefinition<F>;
+export declare function defineSchema<const M extends Metaobjects, const F extends Metafields>(schema: {
+    readonly metaobjects: M & ValidMetaobjects<M, keyof M>;
+    readonly metafields: F & ValidMetafields<F, keyof M>;
+}): SchemaDefinition<M, F>;
+export {};
+//# sourceMappingURL=builders.d.ts.map

package/dist/builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../src/builders.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,OAAO,EACZ,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,GAAG,EAER,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAC;AAEpB,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAA;CAAE,GAAG,IAAI,GAAG,KAAK,CAAC;AAgC5E,eAAO,MAAM,KAAK;iBACH,CAAC,SAAS,WAAW,iBAAuB,CAAC;eAG/C,CAAC,SAAS,WAAW,iBAAuB,CAAC;mBAGzC,CAAC,SAAS,YAAY,iBAAuB,CAAC;kBAG/C,CAAC,SAAS,aAAa,iBAAuB,CAAC;kBAG/C,CAAC,SAAS,aAAa,iBAAuB,CAAC;kBAG/C,CAAC,SAAS,YAAY,iBAAuB,CAAC;cAGlD,CAAC,SAAS,YAAY,iBAAuB,CAAC;SAGnD,KAAK,kBAAkB,CAAC,SAAS,WAAW,0BAAgC,CAAC;kBAGpE,CAAC,SAAS,YAAY,iBAAuB,CAAC;kBAG9C,CAAC,SAAS,YAAY,iBAAuB,CAAC;qBAG3C,CAAC,SAAS,YAAY,iBAAuB,CAAC;eAGpD,CAAC,SAAS,YAAY,iBAAuB,CAAC;qBAGxC,GAAG,SAAS,MAAM,QAAQ,CAAC,SAAS,YAAY,YAAY,GAAG,YAAkB,CAAC;0BAQ7E,IAAI,SAAS,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,YAAY,aACvF,IAAI,YACM,CAAC;SAUjB,KAAK,EACL,aAAa,SAAS,OAAO,EAC7B,OAAO,SAAS,MAAM,QAChB,CAAC,SAAS,WAAW,cACpB,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,CAAC,YAAkB,CAAC,GAgBnE,eAAe,CAAC,KAAK,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC;CAE1D,CAAC;AAEF,wBAAgB,UAAU,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAC/C,UAAU,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC/B,oBAAoB,CAAC,CAAC,CAAC,CAEzB;AAED,wBAAgB,YAAY,CAAC,KAAK,CAAC,CAAC,SAAS,WAAW,EAAE,KAAK,CAAC,CAAC,SAAS,UAAU,EAClF,MAAM,EAAE;IACN,QAAQ,CAAC,WAAW,EAAE,CAAC,GAAG,gBAAgB,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IACvD,QAAQ,CAAC,UAAU,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;CACtD,GACA,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAaxB"}

package/dist/builders.js

@@ -0,0 +1,103 @@
+import { FIELD_MARKER, METAOBJECT_MARKER, SCHEMA_MARKER, } from './types.js';
+function validations(options, numeric = false) {
+    const result = [];
+    for (const name of ['min', 'max', 'regex']) {
+        const value = options[name];
+        if (value !== undefined)
+            result.push({ name, value: String(value) });
+    }
+    if (options.choices !== undefined) {
+        result.push({ name: 'choices', value: JSON.stringify(options.choices) });
+    }
+    if (options.schema !== undefined) {
+        result.push({ name: 'json_schema', value: JSON.stringify(options.schema) });
+    }
+    return result;
+}
+function makeField(type, options, extraValidations = [], targets = []) {
+    return {
+        __kind: FIELD_MARKER,
+        type,
+        options,
+        validations: [...validations(options), ...extraValidations],
+        targets,
+    };
+}
+export const field = {
+    string(options = {}) {
+        return makeField('single_line_text_field', options);
+    },
+    text(options = {}) {
+        return makeField('multi_line_text_field', options);
+    },
+    richText(options = {}) {
+        return makeField('rich_text_field', options);
+    },
+    integer(options = {}) {
+        return makeField('number_integer', options);
+    },
+    decimal(options = {}) {
+        return makeField('number_decimal', options);
+    },
+    boolean(options = {}) {
+        return makeField('boolean', options);
+    },
+    url(options = {}) {
+        return makeField('url', options);
+    },
+    json(options = {}) {
+        return makeField('json', options);
+    },
+    product(options = {}) {
+        return makeField('product_reference', options);
+    },
+    variant(options = {}) {
+        return makeField('variant_reference', options);
+    },
+    collection(options = {}) {
+        return makeField('collection_reference', options);
+    },
+    file(options = {}) {
+        return makeField('file_reference', options);
+    },
+    metaobject(key, options = {}) {
+        return makeField('metaobject_reference', options, [{ name: 'metaobject_definition_type', value: key }], [key]);
+    },
+    mixedMetaobject(keys, options = {}) {
+        return makeField('mixed_reference', options, [{ name: 'metaobject_definition_types', value: JSON.stringify([...keys].sort()) }], keys);
+    },
+    list(inner, options = {}) {
+        const listValidations = validations(options).map((validation) => ({
+            ...validation,
+            name: validation.name === 'min' || validation.name === 'max'
+                ? `list.${validation.name}`
+                : validation.name,
+        }));
+        const referenceValidations = inner.validations.filter((validation) => validation.name.startsWith('metaobject_definition_'));
+        return {
+            __kind: FIELD_MARKER,
+            type: `list.${inner.type}`,
+            options,
+            validations: [...listValidations, ...referenceValidations],
+            targets: inner.targets,
+        };
+    },
+};
+export function metaobject(definition) {
+    return { __kind: METAOBJECT_MARKER, ...definition };
+}
+export function defineSchema(schema) {
+    for (const [owner, namespaces] of Object.entries(schema.metafields)) {
+        for (const [namespace, fields] of Object.entries(namespaces)) {
+            for (const [key, definition] of Object.entries(fields)) {
+                Object.defineProperty(definition, 'identity', {
+                    value: Object.freeze({ owner, namespace, key }),
+                    enumerable: true,
+                    configurable: false,
+                });
+            }
+        }
+    }
+    return { __kind: SCHEMA_MARKER, ...schema };
+}
+//# sourceMappingURL=builders.js.map

package/dist/builders.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}