@cancia/astro 0.0.1

package/dist/endpoints/upload.js

@@ -0,0 +1,41 @@
+import {
+  detectImageType,
+  isValidSite
+} from "../chunk-5IPHDIC6.js";
+
+// src/endpoints/upload.ts
+import { getCanciaRuntime } from "virtual:cancia/runtime";
+async function POST({ request }) {
+  const { uploadHandler, secret, maxUploadMB } = getCanciaRuntime();
+  if (secret) {
+    const token = request.headers.get("Authorization")?.replace("Bearer ", "").trim();
+    if (token !== secret)
+      return new Response(JSON.stringify({ error: "Unauthorized" }), { status: 401 });
+  }
+  const form = await request.formData().catch(() => null);
+  const file = form?.get("file");
+  const site = form?.get("site");
+  if (!(file instanceof File))
+    return new Response(JSON.stringify({ error: "Missing file field" }), { status: 400 });
+  if (typeof site !== "string" || !isValidSite(site))
+    return new Response(
+      JSON.stringify({ error: "Invalid site (allowed: a-z, 0-9, and . _ -; must start alphanumeric)" }),
+      { status: 400 }
+    );
+  if (file.size > maxUploadMB * 1024 * 1024)
+    return new Response(
+      JSON.stringify({ error: `File too large (max ${maxUploadMB}MB)` }),
+      { status: 413 }
+    );
+  const buf = new Uint8Array(await file.arrayBuffer());
+  const detected = detectImageType(buf);
+  if (!detected)
+    return new Response(JSON.stringify({ error: "File type not allowed" }), { status: 415 });
+  const url = await uploadHandler(file, site, detected);
+  return new Response(JSON.stringify({ url }), {
+    headers: { "Content-Type": "application/json" }
+  });
+}
+export {
+  POST
+};

package/dist/index.d.ts

@@ -0,0 +1,145 @@
+import { AstroIntegration } from 'astro';
+import { C as CanciaStorage, a as CanciaStorageV2 } from './types-BMlLS-OS.js';
+export { b as CanciaKVStore, c as CanciaListStore, d as CanciaPageStore, L as ListEntry, P as PageMeta, e as PageRecord, f as PageSEO, R as Rev, g as RevConflictError } from './types-BMlLS-OS.js';
+import { U as UploadHandler } from './upload-DwCGjXbz.js';
+export { m as makeLocalUploadHandler } from './upload-DwCGjXbz.js';
+export { CanciaLoaderOptions, canciaLoader } from './loader/index.js';
+export { FieldDescription, FieldMeta, FieldWidget, ListDescription, ListSchema, SchemasModule, defineList, describeList } from './schema/index.js';
+export { z } from 'zod';
+import 'astro/loaders';
+
+interface R2UploadHandlerOptions {
+    /** Cloudflare account ID (from R2 dashboard) */
+    accountId: string;
+    /** R2 bucket name */
+    bucket: string;
+    /** R2 access key ID */
+    accessKeyId: string;
+    /** R2 secret access key */
+    secretAccessKey: string;
+    /**
+     * Public base URL for the bucket (e.g. "https://cdn.yoursite.com").
+     * The returned image URL will be: `${publicUrl}/<key>`
+     */
+    publicUrl: string;
+    /**
+     * Optional path prefix inside the bucket (e.g. "cancia/uploads").
+     * Default: "uploads"
+     */
+    prefix?: string;
+}
+declare function makeR2UploadHandler(opts: R2UploadHandlerOptions): UploadHandler;
+
+interface CanciaIntegrationOptions {
+    /** Site identifier — used as namespace in storage. Default: "default" */
+    site?: string;
+    /** Secret token for API auth. Reads CANCIA_TOKEN env var if not set. */
+    token?: string;
+    /**
+     * Available languages. First one is default.
+     * If omitted, automatically derived from Astro's built-in `i18n.locales` config.
+     * Falls back to ["en"] if neither is set.
+     */
+    languages?: string[];
+    /** Accent colour for the toolbar highlight + buttons. Default: "#6366f1" */
+    accentColor?: string;
+    /** Deploy hook URL. Reads CANCIA_DEPLOY_HOOK env var if not set. */
+    deployHook?: string;
+    /**
+     * Custom storage adapter.
+     * Default: SQLite (cancia.db in project root) — works anywhere with Node.
+     * For Cloudflare: pass a D1 adapter.
+     * For Vercel:     pass a KV adapter.
+     * For Netlify:    pass a Blobs adapter.
+     */
+    storage?: CanciaStorage;
+    /** Path to the storage file. For JSON adapter: cancia-content.json. For SQLite: cancia.db. */
+    dbPath?: string;
+    /**
+     * Custom upload handler. Receives a File and site string, returns a URL.
+     * Default: saves to public/uploads/<site>/ and returns a relative URL.
+     * Override with an R2, S3, or Cloudinary handler for production.
+     */
+    uploadHandler?: UploadHandler;
+    /**
+     * R2/S3 upload config. When set, Cancia reads these at server start time
+     * (after .env is loaded) and creates the R2 handler automatically.
+     * Takes precedence over uploadHandler if both are set.
+     * Values can reference env vars — they are resolved at server:setup time.
+     */
+    r2?: R2UploadHandlerOptions | (() => R2UploadHandlerOptions);
+    /** Max upload size in MB. Default: 10 */
+    maxUploadMB?: number;
+    /**
+     * Skip session auth and always show the toolbar.
+     * Use for public demos only — anyone can edit if this is enabled.
+     */
+    public?: boolean;
+    /**
+     * v2 storage adapter (KV + pages + lists). When omitted, Cancia builds a
+     * JSON-file v2 adapter automatically at <projectRoot>/.cancia/. List/page
+     * routes return 503 if v2 is explicitly set to null.
+     */
+    storageV2?: CanciaStorageV2 | null;
+    /**
+     * Override the path to the schemas module. Defaults to
+     * `<projectRoot>/src/cms/schemas.ts`. The file must export `schemas`
+     * (named or default) — a record of list name → defineList() output.
+     */
+    schemasPath?: string;
+}
+declare function canciaIntegration(opts?: CanciaIntegrationOptions): AstroIntegration;
+
+type CMSData = Record<string, string>;
+/**
+ * Fetches all CMS overrides for a site from the Cancia API.
+ * Call this in your Astro layout or a shared data-fetching utility.
+ *
+ * @example
+ * // src/i18n/cms.ts
+ * import { fetchCMSData } from "@cancia/astro";
+ * export const cmsData = await fetchCMSData({
+ *   apiUrl: import.meta.env.CANCIA_API_URL,
+ *   site: import.meta.env.CANCIA_SITE,
+ *   token: import.meta.env.CANCIA_TOKEN,
+ * });
+ */
+declare function fetchCMSData(opts: {
+    apiUrl: string;
+    site: string;
+    token?: string;
+}): Promise<CMSData>;
+
+/**
+ * Enhanced useTranslations — identical API to the standard Astro i18n pattern,
+ * but accepts optional CMS data to override individual keys.
+ *
+ * @example
+ * // src/i18n/utils.ts
+ * import { makeUseTranslations } from "@cancia/astro";
+ * import { ui, defaultLang } from "./ui";
+ * export const useTranslations = makeUseTranslations(ui, defaultLang);
+ *
+ * // In your .astro component:
+ * const t = useTranslations(lang, cmsData);
+ * t("hero.title") // returns CMS override if present, else ui.ts value
+ */
+declare function makeUseTranslations<TUI extends Record<string, Record<string, string>>, TLang extends keyof TUI>(ui: TUI, defaultLang: TLang): (lang: TLang, cmsData?: CMSData) => (key: keyof TUI[TLang]) => string;
+
+declare function createJsonFileAdapter(filePath?: string): CanciaStorage;
+
+interface JsonFileV2Options {
+    /** Project root. Defaults to process.cwd(). */
+    projectRoot?: string;
+    /** Override the KV file path. Defaults to <root>/cancia-content.json. */
+    kvPath?: string;
+    /** Override the pages file path. Defaults to <root>/.cancia/pages.json. */
+    pagesPath?: string;
+    /** Override the lists directory. Defaults to <root>/.cancia/lists. */
+    listsDir?: string;
+}
+declare function createJsonFileAdapterV2(opts?: JsonFileV2Options): CanciaStorageV2;
+
+declare function createSQLiteAdapter(dbPath?: string): CanciaStorage;
+
+export { type CMSData, type CanciaIntegrationOptions, CanciaStorage, CanciaStorageV2, type R2UploadHandlerOptions, UploadHandler, canciaIntegration, createJsonFileAdapter, createJsonFileAdapterV2, createSQLiteAdapter, canciaIntegration as default, fetchCMSData, makeR2UploadHandler, makeUseTranslations };