@fmaplabs/meta-manifest 0.1.0

package/dist/node/client.cjs

@@ -0,0 +1,65 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/node/client.ts
+var client_exports = {};
+__export(client_exports, {
+  createAdminClient: () => createAdminClient
+});
+module.exports = __toCommonJS(client_exports);
+
+// src/sync/client.ts
+var SyncTransportError = class extends Error {
+  constructor(message, errors) {
+    super(message);
+    this.errors = errors;
+    this.name = "SyncTransportError";
+  }
+  errors;
+};
+
+// src/config.ts
+var DEFAULT_API_VERSION = "2026-07";
+
+// src/node/client.ts
+function createAdminClient(opts) {
+  const version = opts.apiVersion ?? DEFAULT_API_VERSION;
+  const endpoint = `https://${opts.shop}/admin/api/${version}/graphql.json`;
+  return async (query, options) => {
+    let res;
+    try {
+      res = await fetch(endpoint, {
+        method: "POST",
+        headers: { "Content-Type": "application/json", "X-Shopify-Access-Token": opts.accessToken },
+        body: JSON.stringify({ query, variables: options?.variables })
+      });
+    } catch (cause) {
+      throw new SyncTransportError(`Request to ${opts.shop} failed`, cause);
+    }
+    if (!res.ok) {
+      throw new SyncTransportError(`Admin API returned HTTP ${res.status}`, await res.text().catch(() => null));
+    }
+    return res.json();
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createAdminClient
+});
+//# sourceMappingURL=client.cjs.map

package/dist/node/client.cjs.map

@@ -0,0 +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":[]}

package/dist/node/client.d.cts

@@ -0,0 +1,14 @@
+import { A as AdminGraphQLClient } from '../client-CdkKviW2.cjs';
+
+/**
+ * Build an AdminGraphQLClient that talks directly to a store using an Admin API
+ * access token — the CLI's standalone equivalent of the app's session-based
+ * `admin.graphql` wrapper. [design §2]
+ */
+declare function createAdminClient(opts: {
+    shop: string;
+    accessToken: string;
+    apiVersion?: string;
+}): AdminGraphQLClient;
+
+export { createAdminClient };

package/dist/node/client.d.ts

@@ -0,0 +1,14 @@
+import { A as AdminGraphQLClient } from '../client-CdkKviW2.js';
+
+/**
+ * Build an AdminGraphQLClient that talks directly to a store using an Admin API
+ * access token — the CLI's standalone equivalent of the app's session-based
+ * `admin.graphql` wrapper. [design §2]
+ */
+declare function createAdminClient(opts: {
+    shop: string;
+    accessToken: string;
+    apiVersion?: string;
+}): AdminGraphQLClient;
+
+export { createAdminClient };

package/dist/node/client.js

@@ -0,0 +1,8 @@
+import {
+  createAdminClient
+} from "../chunk-PFU5VAO7.js";
+import "../chunk-3R6VQ3Z3.js";
+export {
+  createAdminClient
+};
+//# sourceMappingURL=client.js.map

package/dist/node/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@fmaplabs/meta-manifest",
+  "version": "0.1.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"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=20.19 <22 || >=22.12"
+  },
+  "author": "kyle",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fmaplabs/meta-manifest.git"
+  },
+  "homepage": "https://github.com/fmaplabs/meta-manifest#readme",
+  "bugs": "https://github.com/fmaplabs/meta-manifest/issues",
+  "keywords": [
+    "shopify",
+    "metaobject",
+    "metaobjects",
+    "metafields",
+    "schema",
+    "cli",
+    "codegen",
+    "admin-api"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./node": {
+      "types": "./dist/node/client.d.ts",
+      "import": "./dist/node/client.js",
+      "require": "./dist/node/client.cjs"
+    }
+  },
+  "bin": {
+    "meta-manifest": "./dist/cli/index.js",
+    "mm": "./dist/cli/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm build",
+    "release": "pnpm test && pnpm typecheck && npm publish --access public",
+    "release:patch": "npm version patch && pnpm release && git push --follow-tags",
+    "release:minor": "npm version minor && pnpm release && git push --follow-tags",
+    "release:major": "npm version major && pnpm release && git push --follow-tags"
+  },
+  "dependencies": {
+    "jiti": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.18.8",
+    "tsup": "^8.3.5",
+    "tsx": "^4.19.0",
+    "typescript": "^5.9.3",
+    "vitest": "^2.1.0"
+  }
+}