@fmaplabs/meta-manifest 0.2.0 → 0.4.0

package/dist/index.d.ts

@@ -11,6 +11,10 @@ interface Config {
     apiVersion?: string;
     /** Path to the schema module whose `schemas` export drives diff/push, and pull writes. */
     schema: string;
+    /** Scope for all metaobjects, unless overridden per-metaobject. Defaults to "app". */
+    scope?: "app" | "merchant";
+    /** Default admin access for app-scoped metaobjects: false → merchant_read, true → merchant_read_write. Defaults to false. */
+    merchantEditable?: boolean;
 }
 /** Identity helper for type inference in `meta-manifest.config.ts`. */
 declare function defineConfig(config: Config): Config;
@@ -65,6 +69,14 @@ type DecodeResult<T> = {
     value?: undefined;
     issues: Issue[];
 };
+/** Options every field builder accepts, regardless of type. */
+interface CommonFieldOptions {
+    name?: string;
+    description?: string;
+    required?: boolean;
+    /** Expose this field as a filter in the admin (→ `capabilities.adminFilterable`). */
+    filterable?: boolean;
+}
 declare abstract class Field<TOut, TIn = TOut, Req extends boolean = false> {
     abstract readonly shopifyType: string;
     /** True when Shopify stores this type as a JSON string (objects, lists). */
@@ -72,6 +84,9 @@ declare abstract class Field<TOut, TIn = TOut, Req extends boolean = false> {
     required: boolean;
     name?: string;
     description?: string;
+    filterable: boolean;
+    /** Apply the shared field options; call from each concrete constructor. */
+    protected applyCommon(opts: CommonFieldOptions): void;
     readonly _out: TOut;
     readonly _in: TIn;
     readonly _req: Req;
@@ -96,9 +111,7 @@ declare abstract class Field<TOut, TIn = TOut, Req extends boolean = false> {
     get ["~standard"](): StandardSchemaV1.Props<TIn, TOut>;
 }
 
-interface BooleanOptions<R extends boolean = false> {
-    name?: string;
-    description?: string;
+interface BooleanOptions<R extends boolean = false> extends CommonFieldOptions {
     required?: R;
 }
 declare class BooleanField<R extends boolean> extends Field<boolean, boolean, R> {
@@ -112,9 +125,7 @@ declare function boolean<R extends boolean = false>(opts?: BooleanOptions<R>): B
 
 type InnerOut<E> = E extends Field<infer O, any, any> ? O : never;
 type InnerIn<E> = E extends Field<any, infer I, any> ? I : never;
-interface ListOptions<R extends boolean = false> {
-    name?: string;
-    description?: string;
+interface ListOptions<R extends boolean = false> extends CommonFieldOptions {
     required?: R;
     min?: number;
     max?: number;
@@ -135,9 +146,7 @@ interface Measure {
     value: number;
     unit: string;
 }
-interface MeasureOptions<R extends boolean = false> {
-    name?: string;
-    description?: string;
+interface MeasureOptions<R extends boolean = false> extends CommonFieldOptions {
     required?: R;
 }
 declare class MeasurementField<R extends boolean> extends Field<Measure, Measure, R> {
@@ -156,9 +165,7 @@ interface Money {
     amount: string;
     currencyCode: string;
 }
-interface MoneyOptions<R extends boolean = false> {
-    name?: string;
-    description?: string;
+interface MoneyOptions<R extends boolean = false> extends CommonFieldOptions {
     required?: R;
 }
 declare class MoneyField<R extends boolean> extends Field<Money, Money, R> {
@@ -171,9 +178,7 @@ declare class MoneyField<R extends boolean> extends Field<Money, Money, R> {
 }
 declare function money<R extends boolean = false>(opts?: MoneyOptions<R>): MoneyField<R>;
 
-interface NumberOptions<R extends boolean = false> {
-    name?: string;
-    description?: string;
+interface NumberOptions<R extends boolean = false> extends CommonFieldOptions {
     required?: R;
     min?: number;
     max?: number;
@@ -212,9 +217,7 @@ interface Rating {
 interface RatingInput {
     value: number;
 }
-interface RatingOptions<R extends boolean = false> {
-    name?: string;
-    description?: string;
+interface RatingOptions<R extends boolean = false> extends CommonFieldOptions {
     required?: R;
     min: number;
     max: number;
@@ -232,9 +235,7 @@ declare class RatingField<R extends boolean> extends Field<Rating, RatingInput,
 }
 declare function rating<R extends boolean = false>(opts: RatingOptions<R>): RatingField<R>;
 
-interface RefOptions<R extends boolean = false> {
-    name?: string;
-    description?: string;
+interface RefOptions<R extends boolean = false> extends CommonFieldOptions {
     required?: R;
 }
 declare abstract class GidField<R extends boolean> extends Field<string, string, R> {
@@ -268,16 +269,21 @@ declare class MetaobjectRefField<R extends boolean> extends GidField<R> {
     constructor(target: TypeRef, opts: RefOptions<R>);
     validations(): FieldValidation[];
 }
+declare class MixedRefField<R extends boolean> extends GidField<R> {
+    private readonly targets;
+    readonly shopifyType = "mixed_reference";
+    constructor(targets: readonly TypeRef[], opts: RefOptions<R>);
+    validations(): FieldValidation[];
+}
 declare function product<R extends boolean = false>(opts?: RefOptions<R>): SimpleRefField<R>;
 declare function variant<R extends boolean = false>(opts?: RefOptions<R>): SimpleRefField<R>;
 declare function collection<R extends boolean = false>(opts?: RefOptions<R>): SimpleRefField<R>;
 declare function page<R extends boolean = false>(opts?: RefOptions<R>): SimpleRefField<R>;
 declare function file<R extends boolean = false>(opts?: FileOptions<R>): FileField<R>;
 declare function ref<R extends boolean = false>(target: TypeRef, opts?: RefOptions<R>): MetaobjectRefField<R>;
+declare function mixedRef<R extends boolean = false>(targets: readonly TypeRef[], opts?: RefOptions<R>): MixedRefField<R>;
 
-interface BaseOptions<R extends boolean = false> {
-    name?: string;
-    description?: string;
+interface BaseOptions<R extends boolean = false> extends CommonFieldOptions {
     required?: R;
 }
 declare abstract class StringScalarField<R extends boolean> extends Field<string, string, R> {
@@ -323,9 +329,7 @@ declare function url<R extends boolean = false>(opts?: UrlOptions<R>): UrlField<
 declare function color<R extends boolean = false>(opts?: BaseOptions<R>): ColorField<R>;
 declare function json<R extends boolean = false>(opts?: BaseOptions<R>): JsonField<R>;
 
-interface TextOptions<R extends boolean = false> {
-    name?: string;
-    description?: string;
+interface TextOptions<R extends boolean = false> extends CommonFieldOptions {
     required?: R;
     min?: number;
     max?: number;
@@ -367,6 +371,7 @@ declare const m: {
     readonly page: typeof page;
     readonly file: typeof file;
     readonly ref: typeof ref;
+    readonly mixedRef: typeof mixedRef;
     readonly list: typeof list;
 };
 
@@ -392,6 +397,11 @@ type InferInput<F extends FieldMap> = Simplify<{
     [K in OptionalKeys<F>]?: FieldIn<F[K]>;
 }>;
 
+interface FieldCapabilitiesInput {
+    adminFilterable?: {
+        enabled: boolean;
+    };
+}
 interface FieldDefinitionInput {
     key: string;
     name: string;
@@ -399,19 +409,44 @@ interface FieldDefinitionInput {
     required: boolean;
     type: string;
     validations: FieldValidation[];
+    capabilities?: FieldCapabilitiesInput;
+}
+interface AccessInput {
+    admin?: string;
+    storefront?: string;
+    customerAccount?: string;
+}
+interface RenderableData {
+    metaTitleKey?: string;
+    metaDescriptionKey?: string;
+}
+interface OnlineStoreData {
+    urlHandle: string;
+    createRedirects?: boolean;
+}
+interface CapabilitiesInput {
+    publishable?: {
+        enabled: boolean;
+    };
+    translatable?: {
+        enabled: boolean;
+    };
+    renderable?: {
+        enabled: boolean;
+        data?: RenderableData;
+    };
+    onlineStore?: {
+        enabled: boolean;
+        data?: OnlineStoreData;
+    };
 }
 interface MetaobjectDefinitionInput {
     type: string;
     name: string;
     description?: string;
     displayNameKey?: string;
-    access?: {
-        admin?: string;
-        storefront?: string;
-    };
-    capabilities?: Record<string, {
-        enabled: boolean;
-    }>;
+    access?: AccessInput;
+    capabilities?: CapabilitiesInput;
     fieldDefinitions: FieldDefinitionInput[];
 }
 declare function toDefinitionInput<F extends FieldMap>(schema: MetaobjectSchema<F>): MetaobjectDefinitionInput;
@@ -419,16 +454,30 @@ declare function toDefinitionInput<F extends FieldMap>(schema: MetaobjectSchema<
 interface AccessConfig {
     admin?: "merchant_read" | "merchant_read_write";
     storefront?: "public_read" | "none";
+    customerAccount?: "none" | "read";
+}
+/** SEO metadata: `true` enables with auto keys; an object maps field keys as title/description. */
+type RenderableConfig = boolean | {
+    metaTitleKey?: string;
+    metaDescriptionKey?: string;
+};
+/** Publish entries as Online Store web pages. `urlHandle` is required by Shopify. */
+interface OnlineStoreConfig {
+    urlHandle: string;
+    createRedirects?: boolean;
 }
 interface CapabilitiesConfig {
     publishable?: boolean;
     translatable?: boolean;
-    renderable?: boolean;
+    renderable?: RenderableConfig;
+    onlineStore?: OnlineStoreConfig;
 }
 interface MetaobjectConfig<F> {
     name: string;
     description?: string;
     displayName?: keyof F & string;
+    /** Override the global config scope for this metaobject. */
+    scope?: "app" | "merchant";
     access?: AccessConfig;
     capabilities?: CapabilitiesConfig;
     fields: F;
@@ -459,17 +508,54 @@ interface MetaobjectSchema<F extends FieldMap> {
 }
 declare function defineMetaobject<F extends Record<string, unknown>>(handle: string, config: MetaobjectConfig<F>): F extends FieldMap ? MetaobjectSchema<F> : never;
 
+interface RemoteAccess {
+    admin?: string;
+    storefront?: string;
+    customerAccount?: string;
+}
+/** Normalized capability comparison shape. `enabled` is compared for every capability
+ * present locally; `data` keys are compared only when locally declared. [design §8] */
+interface RemoteRenderable {
+    enabled: boolean;
+    data?: {
+        metaTitleKey?: string;
+        metaDescriptionKey?: string;
+    };
+}
+interface RemoteOnlineStore {
+    enabled: boolean;
+    data?: {
+        urlHandle?: string;
+    };
+}
+interface RemoteCapabilities {
+    publishable?: {
+        enabled: boolean;
+    };
+    translatable?: {
+        enabled: boolean;
+    };
+    renderable?: RemoteRenderable;
+    onlineStore?: RemoteOnlineStore;
+}
 interface RemoteField {
     key: string;
     type: string;
     required: boolean;
+    filterable: boolean;
     validations: FieldValidation[];
 }
 interface RemoteDefinition {
     type: string;
     name?: string;
+    description?: string;
+    displayNameKey?: string;
+    access?: RemoteAccess;
+    capabilities?: RemoteCapabilities;
     fields: RemoteField[];
 }
+/** Normalize a (already scope-resolved) definition input to the diff shape. */
+declare function normalizeDefinition(def: MetaobjectDefinitionInput): RemoteDefinition;
 declare function normalizeLocal<F extends FieldMap>(schema: MetaobjectSchema<F>): RemoteDefinition;
 interface PulledFieldDefinition {
     key: string;
@@ -478,10 +564,45 @@ interface PulledFieldDefinition {
     } | string;
     required: boolean;
     validations?: FieldValidation[];
+    capabilities?: {
+        adminFilterable?: {
+            enabled: boolean;
+        } | null;
+    } | null;
+}
+interface PulledAccess {
+    admin?: string | null;
+    storefront?: string | null;
+    customerAccount?: string | null;
+}
+interface PulledCapabilities {
+    publishable?: {
+        enabled: boolean;
+    } | null;
+    translatable?: {
+        enabled: boolean;
+    } | null;
+    renderable?: {
+        enabled: boolean;
+        data?: {
+            metaTitleKey?: string | null;
+            metaDescriptionKey?: string | null;
+        } | null;
+    } | null;
+    onlineStore?: {
+        enabled: boolean;
+        data?: {
+            urlHandle?: string | null;
+        } | null;
+    } | null;
 }
 interface PulledDefinition {
     type: string;
     name?: string;
+    description?: string | null;
+    displayNameKey?: string | null;
+    access?: PulledAccess | null;
+    capabilities?: PulledCapabilities | null;
     fieldDefinitions: PulledFieldDefinition[];
 }
 declare function normalizeRemote(def: PulledDefinition): RemoteDefinition;
@@ -493,10 +614,17 @@ declare function normalizeRemote(def: PulledDefinition): RemoteDefinition;
  */
 declare function generateSchemaSource(defs: RemoteDefinition[]): string;
 
+/** Definition-level metadata that `updateDefinition` reconciles. */
+type DefinitionChange = "name" | "description" | "displayNameKey" | "access" | "capabilities";
 type DiffOp = {
     kind: "createDefinition";
     type: string;
     definition: RemoteDefinition;
+} | {
+    kind: "updateDefinition";
+    type: string;
+    changes: DefinitionChange[];
+    destructive?: true;
 } | {
     kind: "addField";
     type: string;
@@ -521,6 +649,18 @@ type DiffOp = {
 };
 declare function diff(local: RemoteDefinition[], remote: RemoteDefinition[]): DiffOp[];
 
+type AnySchema$1 = MetaobjectSchema<any>;
+/** The subset of config that scope resolution reads. */
+type ScopeConfig = Pick<Config, "scope" | "merchantEditable">;
+type Scope = "app" | "merchant";
+/**
+ * Resolve each schema's canonical (`$app:`) definition input into the effective
+ * input the sync pipeline pushes: definition `type` and reference targets are
+ * rewritten to each metaobject's effective scope, and `access.admin` is resolved.
+ * `schema.type` / `m.ref` public values are unchanged. [design §6]
+ */
+declare function resolveDefinitions(schemas: AnySchema$1[], config?: ScopeConfig): MetaobjectDefinitionInput[];
+
 /**
  * A definition read back from the store. `type` is the canonical "$app:…" key
  * (the REQUESTED type, re-labeled from the resolved `app--…` form Shopify
@@ -589,8 +729,10 @@ type UserError = {
  * thrown); only transport / top-level GraphQL errors propagate. [design §7, §8]
  *
  * Create ops run in dependency order (a referenced type before its referencer);
- * types in a reference cycle are `blocked`. Results are returned in plan order;
- * client calls happen in execution order. [design §7]
+ * types entangled in a reference cycle are created two-pass — created with the
+ * cycle-breaking ref fields stripped, then updated to add them once every member
+ * exists. Results are returned in plan order; client calls happen in execution
+ * order. [design §7]
  */
 declare function push(client: AdminGraphQLClient, plan: DiffOp[], sources: {
     definitions: MetaobjectDefinitionInput[];
@@ -599,4 +741,4 @@ declare function push(client: AdminGraphQLClient, plan: DiffOp[], sources: {
 
 type AnySchema = MetaobjectSchema<any>;
 
-export { type AccessConfig, AdminGraphQLClient, type AnySchema, type CapabilitiesConfig, type Config, DEFAULT_API_VERSION, type DecodeResult, type DiffOp, Field, type FieldDefinitionInput, type FieldValidation, type FileType, type Infer, type InferInput, type Issue, type Measure, type MetaobjectConfig, type MetaobjectDefinitionInput, type MetaobjectSchema, type Money, type ParseInput, type PulledRemote, type PushOpResult, type PushOptions, type PushResult, type Rating, type RatingInput, type RemoteDefinition, type RemoteField, StandardSchemaV1, type TypeRef, defineConfig, defineMetaobject, diff, generateSchemaSource, m, normalizeLocal, normalizeRemote, pull, pullAll, push, toDefinitionInput, validateConfig };
+export { type AccessConfig, AdminGraphQLClient, type AnySchema, type CapabilitiesConfig, type Config, DEFAULT_API_VERSION, type DecodeResult, type DefinitionChange, type DiffOp, Field, type FieldDefinitionInput, type FieldValidation, type FileType, type Infer, type InferInput, type Issue, type Measure, type MetaobjectConfig, type MetaobjectDefinitionInput, type MetaobjectSchema, type Money, type ParseInput, type PulledDefinition, type PulledRemote, type PushOpResult, type PushOptions, type PushResult, type Rating, type RatingInput, type RemoteAccess, type RemoteCapabilities, type RemoteDefinition, type RemoteField, type Scope, type ScopeConfig, StandardSchemaV1, type TypeRef, defineConfig, defineMetaobject, diff, generateSchemaSource, m, normalizeDefinition, normalizeLocal, normalizeRemote, pull, pullAll, push, resolveDefinitions, toDefinitionInput, validateConfig };

package/dist/index.js

@@ -4,19 +4,21 @@ import {
   diff,
   generateSchemaSource,
   m,
+  normalizeDefinition,
   normalizeLocal,
   normalizeRemote,
   pull,
   pullAll,
   push,
+  resolveDefinitions,
   toDefinitionInput
-} from "./chunk-GH5DXHS5.js";
+} from "./chunk-OEJJXMYC.js";
 import {
   DEFAULT_API_VERSION,
   SyncTransportError,
   defineConfig,
   validateConfig
-} from "./chunk-3R6VQ3Z3.js";
+} from "./chunk-VSJUGUH7.js";
 export {
   DEFAULT_API_VERSION,
   Field,
@@ -26,11 +28,13 @@ export {
   diff,
   generateSchemaSource,
   m,
+  normalizeDefinition,
   normalizeLocal,
   normalizeRemote,
   pull,
   pullAll,
   push,
+  resolveDefinitions,
   toDefinitionInput,
   validateConfig
 };

package/dist/node/client.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/node/client.ts","../../src/sync/client.ts","../../src/config.ts"],"sourcesContent":["import type { AdminGraphQLClient } from \"../sync/client\";\nimport { SyncTransportError } from \"../sync/client\";\nimport { DEFAULT_API_VERSION } from \"../config\";\n\n/**\n * Build an AdminGraphQLClient that talks directly to a store using an Admin API\n * access token — the CLI's standalone equivalent of the app's session-based\n * `admin.graphql` wrapper. [design §2]\n */\nexport function createAdminClient(opts: {\n  shop: string;\n  accessToken: string;\n  apiVersion?: string;\n}): AdminGraphQLClient {\n  const version = opts.apiVersion ?? DEFAULT_API_VERSION;\n  const endpoint = `https://${opts.shop}/admin/api/${version}/graphql.json`;\n  return async (query, options) => {\n    let res: Response;\n    try {\n      res = await fetch(endpoint, {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\", \"X-Shopify-Access-Token\": opts.accessToken },\n        body: JSON.stringify({ query, variables: options?.variables }),\n      });\n    } catch (cause) {\n      throw new SyncTransportError(`Request to ${opts.shop} failed`, cause);\n    }\n    if (!res.ok) {\n      throw new SyncTransportError(`Admin API returned HTTP ${res.status}`, await res.text().catch(() => null));\n    }\n    return res.json() as Promise<{ data?: unknown; errors?: unknown }>;\n  };\n}\n","/**\n * The minimal Admin GraphQL transport the sync adapter depends on. The app\n * supplies a concrete implementation at its edge (wrapping `admin.graphql`),\n * keeping `@fmaplabs/meta-manifest` free of any runtime dependency on a GraphQL\n * client. [design §5]\n */\nexport interface AdminGraphQLClient {\n  (query: string, options?: { variables?: Record<string, unknown> }): Promise<{ data?: unknown; errors?: unknown }>;\n}\n\n// GraphQL operation strings, copied verbatim from the schema-validated documents\n// in the design spec §3. Re-validated against Admin API 2026-07 during planning.\n// Do not edit by hand — keep equal to the validated documents (drift guard, §12).\n\nexport const PULL_DEFINITION_QUERY = `query PullMetaobjectDefinition($type: String!) {\n  metaobjectDefinitionByType(type: $type) {\n    id\n    name\n    type\n    description\n    displayNameKey\n    fieldDefinitions {\n      key\n      name\n      description\n      required\n      type { name }\n      validations { name value }\n    }\n    access { admin storefront }\n    capabilities {\n      publishable { enabled }\n      translatable { enabled }\n      renderable { enabled }\n    }\n  }\n}`;\n\nexport const LIST_DEFINITIONS_QUERY = `query ListMetaobjectDefinitions($after: String) {\n  metaobjectDefinitions(first: 50, after: $after) {\n    nodes {\n      id\n      name\n      type\n      fieldDefinitions {\n        key\n        name\n        description\n        required\n        type { name }\n        validations { name value }\n      }\n    }\n    pageInfo { hasNextPage endCursor }\n  }\n}`;\n\nexport const CREATE_DEFINITION_MUTATION = `mutation CreateMetaobjectDefinition($definition: MetaobjectDefinitionCreateInput!) {\n  metaobjectDefinitionCreate(definition: $definition) {\n    metaobjectDefinition { id type }\n    userErrors { field message code }\n  }\n}`;\n\nexport const UPDATE_DEFINITION_MUTATION = `mutation UpdateMetaobjectDefinition($id: ID!, $definition: MetaobjectDefinitionUpdateInput!) {\n  metaobjectDefinitionUpdate(id: $id, definition: $definition) {\n    metaobjectDefinition { id type }\n    userErrors { field message code }\n  }\n}`;\n\n/**\n * Thrown when a request fails at the transport or top-level GraphQL layer —\n * distinct from per-op `userErrors`, which `push` reports as `failed` rather\n * than throwing. Carries the offending top-level `errors` payload. [design §5]\n */\nexport class SyncTransportError extends Error {\n  constructor(message: string, readonly errors: unknown) {\n    super(message);\n    this.name = \"SyncTransportError\";\n  }\n}\n\n/**\n * Runs an operation through the injected client and returns its `data`.\n * A non-empty top-level `errors` payload becomes a `SyncTransportError`;\n * a rejected transport promise propagates unchanged. [design §5]\n */\nexport async function execute<T>(\n  client: AdminGraphQLClient,\n  query: string,\n  variables?: Record<string, unknown>,\n): Promise<T> {\n  const result = await client(query, variables ? { variables } : undefined);\n  if (Array.isArray(result.errors) ? result.errors.length > 0 : result.errors != null) {\n    throw new SyncTransportError(\"GraphQL request failed\", result.errors);\n  }\n  return result.data as T;\n}\n","export const DEFAULT_API_VERSION = \"2026-07\";\n\nexport interface Config {\n  /** e.g. \"my-store.myshopify.com\" */\n  shop: string;\n  /** Admin API access token; reference via process.env in your config file. */\n  accessToken: string;\n  /** Admin API version. Defaults to DEFAULT_API_VERSION. */\n  apiVersion?: string;\n  /** Path to the schema module whose `schemas` export drives diff/push, and pull writes. */\n  schema: string;\n}\n\n/** Identity helper for type inference in `meta-manifest.config.ts`. */\nexport function defineConfig(config: Config): Config {\n  return config;\n}\n\n/** Validate a loaded config object, throwing a one-line Error naming the first missing field. */\nexport function validateConfig(raw: unknown): Config {\n  const c = raw as Partial<Config> | null | undefined;\n  for (const key of [\"shop\", \"accessToken\", \"schema\"] as const) {\n    if (!c || typeof c[key] !== \"string\" || c[key] === \"\") {\n      throw new Error(`Invalid config: missing or empty \"${key}\".`);\n    }\n  }\n  return c as Config;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC4EO,IAAM,qBAAN,cAAiC,MAAM;AAAA,EAC5C,YAAY,SAA0B,QAAiB;AACrD,UAAM,OAAO;AADuB;AAEpC,SAAK,OAAO;AAAA,EACd;AAAA,EAHsC;AAIxC;;;ACjFO,IAAM,sBAAsB;;;AFS5B,SAAS,kBAAkB,MAIX;AACrB,QAAM,UAAU,KAAK,cAAc;AACnC,QAAM,WAAW,WAAW,KAAK,IAAI,cAAc,OAAO;AAC1D,SAAO,OAAO,OAAO,YAAY;AAC/B,QAAI;AACJ,QAAI;AACF,YAAM,MAAM,MAAM,UAAU;AAAA,QAC1B,QAAQ;AAAA,QACR,SAAS,EAAE,gBAAgB,oBAAoB,0BAA0B,KAAK,YAAY;AAAA,QAC1F,MAAM,KAAK,UAAU,EAAE,OAAO,WAAW,SAAS,UAAU,CAAC;AAAA,MAC/D,CAAC;AAAA,IACH,SAAS,OAAO;AACd,YAAM,IAAI,mBAAmB,cAAc,KAAK,IAAI,WAAW,KAAK;AAAA,IACtE;AACA,QAAI,CAAC,IAAI,IAAI;AACX,YAAM,IAAI,mBAAmB,2BAA2B,IAAI,MAAM,IAAI,MAAM,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI,CAAC;AAAA,IAC1G;AACA,WAAO,IAAI,KAAK;AAAA,EAClB;AACF;","names":[]}
+{"version":3,"sources":["../../src/node/client.ts","../../src/sync/client.ts","../../src/config.ts"],"sourcesContent":["import type { AdminGraphQLClient } from \"../sync/client\";\nimport { SyncTransportError } from \"../sync/client\";\nimport { DEFAULT_API_VERSION } from \"../config\";\n\n/**\n * Build an AdminGraphQLClient that talks directly to a store using an Admin API\n * access token — the CLI's standalone equivalent of the app's session-based\n * `admin.graphql` wrapper. [design §2]\n */\nexport function createAdminClient(opts: {\n  shop: string;\n  accessToken: string;\n  apiVersion?: string;\n}): AdminGraphQLClient {\n  const version = opts.apiVersion ?? DEFAULT_API_VERSION;\n  const endpoint = `https://${opts.shop}/admin/api/${version}/graphql.json`;\n  return async (query, options) => {\n    let res: Response;\n    try {\n      res = await fetch(endpoint, {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\", \"X-Shopify-Access-Token\": opts.accessToken },\n        body: JSON.stringify({ query, variables: options?.variables }),\n      });\n    } catch (cause) {\n      throw new SyncTransportError(`Request to ${opts.shop} failed`, cause);\n    }\n    if (!res.ok) {\n      throw new SyncTransportError(`Admin API returned HTTP ${res.status}`, await res.text().catch(() => null));\n    }\n    return res.json() as Promise<{ data?: unknown; errors?: unknown }>;\n  };\n}\n","/**\n * The minimal Admin GraphQL transport the sync adapter depends on. The app\n * supplies a concrete implementation at its edge (wrapping `admin.graphql`),\n * keeping `@fmaplabs/meta-manifest` free of any runtime dependency on a GraphQL\n * client. [design §5]\n */\nexport interface AdminGraphQLClient {\n  (query: string, options?: { variables?: Record<string, unknown> }): Promise<{ data?: unknown; errors?: unknown }>;\n}\n\n// GraphQL operation strings, copied verbatim from the schema-validated documents\n// in the design spec §3. Re-validated against Admin API 2026-07 during planning.\n// Do not edit by hand — keep equal to the validated documents (drift guard, §12).\n\nexport const PULL_DEFINITION_QUERY = `query PullMetaobjectDefinition($type: String!) {\n  metaobjectDefinitionByType(type: $type) {\n    id\n    name\n    type\n    description\n    displayNameKey\n    fieldDefinitions {\n      key\n      name\n      description\n      required\n      type { name }\n      validations { name value }\n      capabilities { adminFilterable { enabled } }\n    }\n    access { admin storefront customerAccount }\n    capabilities {\n      publishable { enabled }\n      translatable { enabled }\n      renderable { enabled data { metaTitleKey metaDescriptionKey } }\n      onlineStore { enabled data { urlHandle } }\n    }\n  }\n}`;\n\nexport const LIST_DEFINITIONS_QUERY = `query ListMetaobjectDefinitions($after: String) {\n  metaobjectDefinitions(first: 50, after: $after) {\n    nodes {\n      id\n      name\n      type\n      description\n      displayNameKey\n      fieldDefinitions {\n        key\n        name\n        description\n        required\n        type { name }\n        validations { name value }\n        capabilities { adminFilterable { enabled } }\n      }\n      access { admin storefront customerAccount }\n      capabilities {\n        publishable { enabled }\n        translatable { enabled }\n        renderable { enabled data { metaTitleKey metaDescriptionKey } }\n        onlineStore { enabled data { urlHandle } }\n      }\n    }\n    pageInfo { hasNextPage endCursor }\n  }\n}`;\n\nexport const CREATE_DEFINITION_MUTATION = `mutation CreateMetaobjectDefinition($definition: MetaobjectDefinitionCreateInput!) {\n  metaobjectDefinitionCreate(definition: $definition) {\n    metaobjectDefinition { id type }\n    userErrors { field message code }\n  }\n}`;\n\nexport const UPDATE_DEFINITION_MUTATION = `mutation UpdateMetaobjectDefinition($id: ID!, $definition: MetaobjectDefinitionUpdateInput!) {\n  metaobjectDefinitionUpdate(id: $id, definition: $definition) {\n    metaobjectDefinition { id type }\n    userErrors { field message code }\n  }\n}`;\n\n/**\n * Thrown when a request fails at the transport or top-level GraphQL layer —\n * distinct from per-op `userErrors`, which `push` reports as `failed` rather\n * than throwing. Carries the offending top-level `errors` payload. [design §5]\n */\nexport class SyncTransportError extends Error {\n  constructor(message: string, readonly errors: unknown) {\n    super(message);\n    this.name = \"SyncTransportError\";\n  }\n}\n\n/**\n * Runs an operation through the injected client and returns its `data`.\n * A non-empty top-level `errors` payload becomes a `SyncTransportError`;\n * a rejected transport promise propagates unchanged. [design §5]\n */\nexport async function execute<T>(\n  client: AdminGraphQLClient,\n  query: string,\n  variables?: Record<string, unknown>,\n): Promise<T> {\n  const result = await client(query, variables ? { variables } : undefined);\n  if (Array.isArray(result.errors) ? result.errors.length > 0 : result.errors != null) {\n    throw new SyncTransportError(\"GraphQL request failed\", result.errors);\n  }\n  return result.data as T;\n}\n","export const DEFAULT_API_VERSION = \"2026-07\";\n\nexport interface Config {\n  /** e.g. \"my-store.myshopify.com\" */\n  shop: string;\n  /** Admin API access token; reference via process.env in your config file. */\n  accessToken: string;\n  /** Admin API version. Defaults to DEFAULT_API_VERSION. */\n  apiVersion?: string;\n  /** Path to the schema module whose `schemas` export drives diff/push, and pull writes. */\n  schema: string;\n  /** Scope for all metaobjects, unless overridden per-metaobject. Defaults to \"app\". */\n  scope?: \"app\" | \"merchant\";\n  /** Default admin access for app-scoped metaobjects: false → merchant_read, true → merchant_read_write. Defaults to false. */\n  merchantEditable?: boolean;\n}\n\n/** Identity helper for type inference in `meta-manifest.config.ts`. */\nexport function defineConfig(config: Config): Config {\n  return config;\n}\n\n/** Validate a loaded config object, throwing a one-line Error naming the first missing field. */\nexport function validateConfig(raw: unknown): Config {\n  const c = raw as Partial<Config> | null | undefined;\n  for (const key of [\"shop\", \"accessToken\", \"schema\"] as const) {\n    if (!c || typeof c[key] !== \"string\" || c[key] === \"\") {\n      throw new Error(`Invalid config: missing or empty \"${key}\".`);\n    }\n  }\n  return c as Config;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACwFO,IAAM,qBAAN,cAAiC,MAAM;AAAA,EAC5C,YAAY,SAA0B,QAAiB;AACrD,UAAM,OAAO;AADuB;AAEpC,SAAK,OAAO;AAAA,EACd;AAAA,EAHsC;AAIxC;;;AC7FO,IAAM,sBAAsB;;;AFS5B,SAAS,kBAAkB,MAIX;AACrB,QAAM,UAAU,KAAK,cAAc;AACnC,QAAM,WAAW,WAAW,KAAK,IAAI,cAAc,OAAO;AAC1D,SAAO,OAAO,OAAO,YAAY;AAC/B,QAAI;AACJ,QAAI;AACF,YAAM,MAAM,MAAM,UAAU;AAAA,QAC1B,QAAQ;AAAA,QACR,SAAS,EAAE,gBAAgB,oBAAoB,0BAA0B,KAAK,YAAY;AAAA,QAC1F,MAAM,KAAK,UAAU,EAAE,OAAO,WAAW,SAAS,UAAU,CAAC;AAAA,MAC/D,CAAC;AAAA,IACH,SAAS,OAAO;AACd,YAAM,IAAI,mBAAmB,cAAc,KAAK,IAAI,WAAW,KAAK;AAAA,IACtE;AACA,QAAI,CAAC,IAAI,IAAI;AACX,YAAM,IAAI,mBAAmB,2BAA2B,IAAI,MAAM,IAAI,MAAM,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI,CAAC;AAAA,IAC1G;AACA,WAAO,IAAI,KAAK;AAAA,EAClB;AACF;","names":[]}

package/dist/node/client.js

@@ -1,7 +1,7 @@
 import {
   createAdminClient
-} from "../chunk-PFU5VAO7.js";
-import "../chunk-3R6VQ3Z3.js";
+} from "../chunk-AUR2YQCW.js";
+import "../chunk-VSJUGUH7.js";
 export {
   createAdminClient
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fmaplabs/meta-manifest",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Zero-dependency, zod-style builder for Shopify metaobject definitions, plus a CLI (mm) that syncs them to a store via pull → diff → push.",
   "publishConfig": {
     "access": "public"

package/dist/chunk-3R6VQ3Z3.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/config.ts","../src/sync/client.ts"],"sourcesContent":["export const DEFAULT_API_VERSION = \"2026-07\";\n\nexport interface Config {\n  /** e.g. \"my-store.myshopify.com\" */\n  shop: string;\n  /** Admin API access token; reference via process.env in your config file. */\n  accessToken: string;\n  /** Admin API version. Defaults to DEFAULT_API_VERSION. */\n  apiVersion?: string;\n  /** Path to the schema module whose `schemas` export drives diff/push, and pull writes. */\n  schema: string;\n}\n\n/** Identity helper for type inference in `meta-manifest.config.ts`. */\nexport function defineConfig(config: Config): Config {\n  return config;\n}\n\n/** Validate a loaded config object, throwing a one-line Error naming the first missing field. */\nexport function validateConfig(raw: unknown): Config {\n  const c = raw as Partial<Config> | null | undefined;\n  for (const key of [\"shop\", \"accessToken\", \"schema\"] as const) {\n    if (!c || typeof c[key] !== \"string\" || c[key] === \"\") {\n      throw new Error(`Invalid config: missing or empty \"${key}\".`);\n    }\n  }\n  return c as Config;\n}\n","/**\n * The minimal Admin GraphQL transport the sync adapter depends on. The app\n * supplies a concrete implementation at its edge (wrapping `admin.graphql`),\n * keeping `@fmaplabs/meta-manifest` free of any runtime dependency on a GraphQL\n * client. [design §5]\n */\nexport interface AdminGraphQLClient {\n  (query: string, options?: { variables?: Record<string, unknown> }): Promise<{ data?: unknown; errors?: unknown }>;\n}\n\n// GraphQL operation strings, copied verbatim from the schema-validated documents\n// in the design spec §3. Re-validated against Admin API 2026-07 during planning.\n// Do not edit by hand — keep equal to the validated documents (drift guard, §12).\n\nexport const PULL_DEFINITION_QUERY = `query PullMetaobjectDefinition($type: String!) {\n  metaobjectDefinitionByType(type: $type) {\n    id\n    name\n    type\n    description\n    displayNameKey\n    fieldDefinitions {\n      key\n      name\n      description\n      required\n      type { name }\n      validations { name value }\n    }\n    access { admin storefront }\n    capabilities {\n      publishable { enabled }\n      translatable { enabled }\n      renderable { enabled }\n    }\n  }\n}`;\n\nexport const LIST_DEFINITIONS_QUERY = `query ListMetaobjectDefinitions($after: String) {\n  metaobjectDefinitions(first: 50, after: $after) {\n    nodes {\n      id\n      name\n      type\n      fieldDefinitions {\n        key\n        name\n        description\n        required\n        type { name }\n        validations { name value }\n      }\n    }\n    pageInfo { hasNextPage endCursor }\n  }\n}`;\n\nexport const CREATE_DEFINITION_MUTATION = `mutation CreateMetaobjectDefinition($definition: MetaobjectDefinitionCreateInput!) {\n  metaobjectDefinitionCreate(definition: $definition) {\n    metaobjectDefinition { id type }\n    userErrors { field message code }\n  }\n}`;\n\nexport const UPDATE_DEFINITION_MUTATION = `mutation UpdateMetaobjectDefinition($id: ID!, $definition: MetaobjectDefinitionUpdateInput!) {\n  metaobjectDefinitionUpdate(id: $id, definition: $definition) {\n    metaobjectDefinition { id type }\n    userErrors { field message code }\n  }\n}`;\n\n/**\n * Thrown when a request fails at the transport or top-level GraphQL layer —\n * distinct from per-op `userErrors`, which `push` reports as `failed` rather\n * than throwing. Carries the offending top-level `errors` payload. [design §5]\n */\nexport class SyncTransportError extends Error {\n  constructor(message: string, readonly errors: unknown) {\n    super(message);\n    this.name = \"SyncTransportError\";\n  }\n}\n\n/**\n * Runs an operation through the injected client and returns its `data`.\n * A non-empty top-level `errors` payload becomes a `SyncTransportError`;\n * a rejected transport promise propagates unchanged. [design §5]\n */\nexport async function execute<T>(\n  client: AdminGraphQLClient,\n  query: string,\n  variables?: Record<string, unknown>,\n): Promise<T> {\n  const result = await client(query, variables ? { variables } : undefined);\n  if (Array.isArray(result.errors) ? result.errors.length > 0 : result.errors != null) {\n    throw new SyncTransportError(\"GraphQL request failed\", result.errors);\n  }\n  return result.data as T;\n}\n"],"mappings":";AAAO,IAAM,sBAAsB;AAc5B,SAAS,aAAa,QAAwB;AACnD,SAAO;AACT;AAGO,SAAS,eAAe,KAAsB;AACnD,QAAM,IAAI;AACV,aAAW,OAAO,CAAC,QAAQ,eAAe,QAAQ,GAAY;AAC5D,QAAI,CAAC,KAAK,OAAO,EAAE,GAAG,MAAM,YAAY,EAAE,GAAG,MAAM,IAAI;AACrD,YAAM,IAAI,MAAM,qCAAqC,GAAG,IAAI;AAAA,IAC9D;AAAA,EACF;AACA,SAAO;AACT;;;ACbO,IAAM,wBAAwB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAwB9B,IAAM,yBAAyB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAmB/B,IAAM,6BAA6B;AAAA;AAAA;AAAA;AAAA;AAAA;AAOnC,IAAM,6BAA6B;AAAA;AAAA;AAAA;AAAA;AAAA;AAYnC,IAAM,qBAAN,cAAiC,MAAM;AAAA,EAC5C,YAAY,SAA0B,QAAiB;AACrD,UAAM,OAAO;AADuB;AAEpC,SAAK,OAAO;AAAA,EACd;AAAA,EAHsC;AAIxC;AAOA,eAAsB,QACpB,QACA,OACA,WACY;AACZ,QAAM,SAAS,MAAM,OAAO,OAAO,YAAY,EAAE,UAAU,IAAI,MAAS;AACxE,MAAI,MAAM,QAAQ,OAAO,MAAM,IAAI,OAAO,OAAO,SAAS,IAAI,OAAO,UAAU,MAAM;AACnF,UAAM,IAAI,mBAAmB,0BAA0B,OAAO,MAAM;AAAA,EACtE;AACA,SAAO,OAAO;AAChB;","names":[]}