@saacms/core 0.1.0

package/dist/index-8g8ymd37.js

@@ -0,0 +1,275 @@
+// src/schema/media.ts
+import { Schema, SchemaAST as AST } from "effect";
+var IntField = Schema.Number.annotations({ saacmsInt: true });
+var _CommonMediaFields = Schema.Struct({
+  mime: Schema.String,
+  size: IntField,
+  width: IntField,
+  height: IntField,
+  uploadedBy: Schema.String
+});
+var _BucketOnlyFields = Schema.Struct({
+  originalKey: Schema.String,
+  originalUrl: Schema.String
+});
+var _RepoOnlyFields = Schema.Struct({
+  repoPath: Schema.String,
+  publicUrl: Schema.String
+});
+var MediaFields = Schema.Struct({
+  mime: Schema.String,
+  size: IntField,
+  width: IntField,
+  height: IntField,
+  uploadedBy: Schema.String,
+  originalKey: Schema.String,
+  originalUrl: Schema.String
+});
+function extractSigs(schema) {
+  const ast = schema.ast;
+  if (!AST.isTypeLiteral(ast)) {
+    throw new Error("extractSigs: expected a Struct (TypeLiteral)");
+  }
+  return ast.propertySignatures;
+}
+var _COMMON_SIGS = extractSigs(_CommonMediaFields);
+var _BUCKET_ONLY_SIGS = extractSigs(_BucketOnlyFields);
+var _REPO_ONLY_SIGS = extractSigs(_RepoOnlyFields);
+var _BUCKET_ALL_SIGS = [
+  ..._COMMON_SIGS,
+  ..._BUCKET_ONLY_SIGS
+];
+var _REPO_ALL_SIGS = [
+  ..._COMMON_SIGS,
+  ..._REPO_ONLY_SIGS
+];
+var MEDIA_FIELD_NAMES = _BUCKET_ALL_SIGS.map((p) => String(p.name));
+var REPO_MEDIA_FIELD_NAMES = _REPO_ALL_SIGS.map((p) => String(p.name));
+function withMediaFields(coll) {
+  if (coll.kind !== "media")
+    return coll;
+  const authorAst = coll.schema.ast;
+  if (!AST.isTypeLiteral(authorAst)) {
+    throw new Error(`withMediaFields: root schema for media collection "${coll.slug}" ` + `must be a Struct (TypeLiteral); got ${authorAst._tag}`);
+  }
+  const mode = coll.storage?.mode ?? "bucket";
+  const injectedSigs = mode === "repo" ? _REPO_ALL_SIGS : _BUCKET_ALL_SIGS;
+  const reservedNames = mode === "repo" ? REPO_MEDIA_FIELD_NAMES : MEDIA_FIELD_NAMES;
+  const authorNames = new Set(authorAst.propertySignatures.map((p) => String(p.name)));
+  for (const name of reservedNames) {
+    if (authorNames.has(name)) {
+      throw new Error(`withMediaFields: collection "${coll.slug}" re-declares reserved ` + `media field "${name}". The ADR-0009 auto-injected fields ` + `(${reservedNames.join(", ")}) are part of a media ` + `Collection's structure and cannot be author-declared.`);
+    }
+  }
+  const merged = new AST.TypeLiteral([...authorAst.propertySignatures, ...injectedSigs], authorAst.indexSignatures, authorAst.annotations);
+  return { ...coll, schema: Schema.make(merged) };
+}
+function MediaRef(slug) {
+  const base = Schema.Struct({
+    id: Schema.String,
+    originalUrl: Schema.String,
+    mime: Schema.String,
+    width: IntField,
+    height: IntField
+  });
+  return slug == null ? base : base.annotations({ description: `MediaRef → ${slug}` });
+}
+function mediaTransformUrl(baseUrl, transform) {
+  const options = buildOptions(transform);
+  if (options === "")
+    return baseUrl;
+  const prefix = `cdn-cgi/image/${options}`;
+  let parsed;
+  try {
+    parsed = new URL(baseUrl);
+  } catch {
+    parsed = undefined;
+  }
+  if (parsed !== undefined) {
+    return `${parsed.origin}/${prefix}${parsed.pathname}${parsed.search}`;
+  }
+  const path = baseUrl.startsWith("/") ? baseUrl : `/${baseUrl}`;
+  return `/${prefix}${path}`;
+}
+function buildOptions(transform) {
+  if (transform === undefined)
+    return "";
+  const parts = [];
+  if (transform.width !== undefined)
+    parts.push(`width=${transform.width}`);
+  if (transform.height !== undefined)
+    parts.push(`height=${transform.height}`);
+  if (transform.format !== undefined)
+    parts.push(`format=${transform.format}`);
+  if (transform.quality !== undefined) {
+    parts.push(`quality=${transform.quality}`);
+  }
+  return parts.join(",");
+}
+function resolveMediaRef(record) {
+  const srcset = () => {
+    throw new Error("MediaRef.srcset is NOT_IMPLEMENTED in v1 (srcset is a documented " + "v1.x follow-up). See ADR 0009 §6 / §5. Use .url({ width }) per " + "breakpoint until then.");
+  };
+  if ("publicUrl" in record) {
+    return {
+      id: record.id,
+      mime: record.mime,
+      width: record.width,
+      height: record.height,
+      url: (_transform) => record.publicUrl,
+      srcset
+    };
+  }
+  return {
+    id: record.id,
+    mime: record.mime,
+    width: record.width,
+    height: record.height,
+    url: (transform) => mediaTransformUrl(record.originalUrl, transform),
+    srcset
+  };
+}
+async function mediaRepoName(opts) {
+  const policy = opts.policy ?? "content-hash";
+  if (policy === "slug") {
+    const slug = toSlug(opts.originalFilename ?? "");
+    if (slug !== "")
+      return `${slug}.${opts.ext}`;
+  }
+  const hashBuffer = await crypto.subtle.digest("SHA-256", opts.bytes);
+  const hex = Array.from(new Uint8Array(hashBuffer)).map((b) => b.toString(16).padStart(2, "0")).join("");
+  return `${hex.slice(0, 16)}.${opts.ext}`;
+}
+function toSlug(filename) {
+  const base = filename.replace(/\.[^.]+$/, "");
+  return base.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function mimeToExt(mime, filename) {
+  if (filename) {
+    const m = filename.match(/\.([^.]+)$/);
+    if (m)
+      return m[1].toLowerCase();
+  }
+  const MAP = {
+    "image/png": "png",
+    "image/jpeg": "jpg",
+    "image/webp": "webp",
+    "image/gif": "gif",
+    "image/avif": "avif",
+    "image/svg+xml": "svg",
+    "image/tiff": "tiff",
+    "application/pdf": "pdf"
+  };
+  return MAP[mime] ?? "bin";
+}
+async function stageRepoMedia(opts) {
+  assertPathSafe(opts.collectionSlug, "collectionSlug");
+  if (opts.originalFilename !== undefined) {
+    assertPathSafe(opts.originalFilename, "originalFilename");
+  }
+  const root = opts.assetRoot.endsWith("/") ? opts.assetRoot : `${opts.assetRoot}/`;
+  const ext = mimeToExt(opts.mime, opts.originalFilename);
+  const name = await mediaRepoName({
+    bytes: opts.bytes,
+    originalFilename: opts.originalFilename,
+    ext,
+    policy: opts.policy
+  });
+  const repoPath = `${root}saacms/${opts.collectionSlug}/${name}`;
+  const publicUrl = `/saacms/${opts.collectionSlug}/${name}`;
+  const bytes = opts.bytes instanceof Uint8Array ? opts.bytes : new Uint8Array(opts.bytes);
+  return { repoPath, publicUrl, bytes };
+}
+function assertPathSafe(value, label) {
+  if (value.includes("..") || value.startsWith("/") || value.includes("\\")) {
+    throw new Error(`stageRepoMedia: unsafe ${label} "${value}" — ` + `reject "..", absolute paths, and backslashes.`);
+  }
+}
+// src/schema/plugin-trust.ts
+var PLUGIN_CAPABILITIES = [
+  "collections",
+  "blocks",
+  "pages",
+  "routes",
+  "hooks",
+  "services",
+  "storage:read",
+  "storage:write",
+  "admin-pages",
+  "migrations"
+];
+function deriveContributedCapabilities(plugin) {
+  const used = new Set;
+  const nonEmptyArr = (v) => Array.isArray(v) && v.length > 0;
+  const nonEmptyRec = (v) => v != null && Object.keys(v).length > 0;
+  if (nonEmptyArr(plugin.collections)) {
+    used.add("collections");
+    used.add("storage:read");
+    used.add("storage:write");
+  }
+  if (nonEmptyArr(plugin.blocks))
+    used.add("blocks");
+  if (nonEmptyArr(plugin.pages))
+    used.add("pages");
+  if (nonEmptyArr(plugin.pageTemplates))
+    used.add("pages");
+  if (nonEmptyRec(plugin.routes))
+    used.add("routes");
+  if (nonEmptyRec(plugin.hooks))
+    used.add("hooks");
+  if (nonEmptyRec(plugin.services))
+    used.add("services");
+  if (nonEmptyArr(plugin.admin?.pages) || nonEmptyArr(plugin.admin?.menu)) {
+    used.add("admin-pages");
+  }
+  if (plugin.migrations?.db != null || plugin.migrations?.content != null) {
+    used.add("migrations");
+  }
+  if (plugin.init != null)
+    used.add("storage:write");
+  return PLUGIN_CAPABILITIES.filter((c) => used.has(c));
+}
+function assertPluginCapabilities(config, opts = {}) {
+  const { strict = false } = opts;
+  const violations = [];
+  const undeclared = [];
+  for (const plugin of config.plugins ?? []) {
+    const name = String(plugin.name);
+    const used = deriveContributedCapabilities(plugin);
+    if (plugin.capabilities == null) {
+      if (used.length > 0)
+        undeclared.push(name);
+      continue;
+    }
+    const declaredSet = new Set(plugin.capabilities);
+    for (const cap of used) {
+      if (!declaredSet.has(cap)) {
+        violations.push({ plugin: name, used: cap, declared: false });
+      }
+    }
+  }
+  const ok = violations.length === 0 && (!strict || undeclared.length === 0);
+  return { ok, violations, undeclared };
+}
+
+// src/schema/index.ts
+function defineCollection(opts) {
+  return opts;
+}
+function definePage(opts) {
+  return opts;
+}
+function definePageTemplate(opts) {
+  return opts;
+}
+function defineBlock(opts) {
+  return opts;
+}
+function definePlugin(opts) {
+  return opts;
+}
+function defineConfig(opts) {
+  return opts;
+}
+
+export { MediaFields, MEDIA_FIELD_NAMES, REPO_MEDIA_FIELD_NAMES, withMediaFields, MediaRef, mediaTransformUrl, resolveMediaRef, mediaRepoName, stageRepoMedia, PLUGIN_CAPABILITIES, deriveContributedCapabilities, assertPluginCapabilities, defineCollection, definePage, definePageTemplate, defineBlock, definePlugin, defineConfig };