@usefillo/core 0.2.1 → 0.2.3

package/dist/index.d.ts

@@ -435,6 +435,38 @@ declare class FilloClient {
     private s3PutUpload;
 }
 declare function createClient(options?: FilloClientOptions): FilloClient;
+interface ProvisionWorkspaceResult {
+    /** Publishable key (pk_…) for the new workspace. Pass to createClient({ key }). */
+    key: string;
+    organizationId: string;
+    /** A claim link was emailed here so the owner can take ownership later. */
+    claim: {
+        email: string;
+        sent: boolean;
+    };
+    /** Caps applied until the workspace is claimed. */
+    limits: {
+        responses: number;
+        expiresAt: string;
+    };
+}
+/**
+ * Provision a Fillo workspace from an email — no signup — and get a publishable
+ * key back, so a form can collect real responses immediately. A claim link is
+ * emailed to `email`; until someone claims it the workspace runs as a capped
+ * preview (limited responses, for a limited time). Built for setup automation,
+ * e.g. a coding agent wiring Fillo into an app during integration.
+ *
+ *   const { key } = await provisionWorkspace({ email: "you@co.com" });
+ *   const client = createClient({ key });
+ */
+declare function provisionWorkspace(options: {
+    email: string;
+    baseUrl?: string;
+    /** Free-form provenance label, e.g. "agent" | "cli". */
+    source?: string;
+    fetch?: typeof fetch;
+}): Promise<ProvisionWorkspaceResult>;
 
 type FormStatus = "idle" | "submitting" | "submitted" | "error";
 interface FormControllerOptions {
@@ -551,4 +583,4 @@ declare function pipeBlock(block: Block, data: ResponseData, form: FormSchema):
 /** Dependency-free nanoid-style id with an unbiased alphabet. Crypto-random. */
 declare function createId(size?: number): string;
 
-export { BLOCK_KIND_META, type BaseField, type Block, type BlockKind, CONTENT_KINDS, type CheckboxField, type ChoiceField, type CodeForm, type Condition, type ConditionOp, type ContentBlock, type ContentKind, type CustomField, DRAFT_KINDS, type DateField, type DividerBlock, type Field, type FieldKind, type FieldSpec, type FieldValue, type FileUploadField, type FileValue, FilloClient, type FilloClientOptions, FilloError, type FormController, type FormControllerOptions, type FormControllerState, type FormDraftSpec, type FormPage, type FormSchema, type FormSettings, type FormStatus, type FormTheme, type HeadingBlock, type HiddenField, type JsonValue, type LinearScaleField, type MatrixField, type NumberField, type ParagraphBlock, type PublishedForm, type RankingField, type RatingField, type ResponseData, type SchemaValidationResult, type SelectOption, type SignatureField, type SubmitMeta, type SubmitResult, type TextField, type UploadFileOptions, type UploadProgress, type UploadSession, type UploadStatus, type UploadTransport, type ValidationResult, allFields, assembleForm, createBlock, createClient, createEmptyForm, createFormController, createId, defineForm, formatAnswer, isBlockVisible, isCodeForm, isField, pipeBlock, prefillFromParams, resolveText, syncCodeForm, validateField, validateFormSchema, validateResponse, visibleBlocks, visibleFields };
+export { BLOCK_KIND_META, type BaseField, type Block, type BlockKind, CONTENT_KINDS, type CheckboxField, type ChoiceField, type CodeForm, type Condition, type ConditionOp, type ContentBlock, type ContentKind, type CustomField, DRAFT_KINDS, type DateField, type DividerBlock, type Field, type FieldKind, type FieldSpec, type FieldValue, type FileUploadField, type FileValue, FilloClient, type FilloClientOptions, FilloError, type FormController, type FormControllerOptions, type FormControllerState, type FormDraftSpec, type FormPage, type FormSchema, type FormSettings, type FormStatus, type FormTheme, type HeadingBlock, type HiddenField, type JsonValue, type LinearScaleField, type MatrixField, type NumberField, type ParagraphBlock, type ProvisionWorkspaceResult, type PublishedForm, type RankingField, type RatingField, type ResponseData, type SchemaValidationResult, type SelectOption, type SignatureField, type SubmitMeta, type SubmitResult, type TextField, type UploadFileOptions, type UploadProgress, type UploadSession, type UploadStatus, type UploadTransport, type ValidationResult, allFields, assembleForm, createBlock, createClient, createEmptyForm, createFormController, createId, defineForm, formatAnswer, isBlockVisible, isCodeForm, isField, pipeBlock, prefillFromParams, provisionWorkspace, resolveText, syncCodeForm, validateField, validateFormSchema, validateResponse, visibleBlocks, visibleFields };

package/dist/index.js

@@ -839,6 +839,20 @@ var FilloClient = class {
 function createClient(options = {}) {
   return new FilloClient(options);
 }
+async function provisionWorkspace(options) {
+  const baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+  const doFetch = options.fetch ?? ((...args) => globalThis.fetch(...args));
+  const res = await doFetch(`${baseUrl}/api/v1/workspaces/provision`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ email: options.email, source: options.source ?? "sdk" })
+  });
+  if (!res.ok) {
+    const body = await res.text().catch(() => "");
+    throw new FilloError(body || `Provision failed: ${res.status}`, res.status);
+  }
+  return await res.json();
+}
 
 // src/controller.ts
 var EMPTY_PAGE = { id: "empty", blocks: [] };
@@ -1133,6 +1147,7 @@ export {
   isField,
   pipeBlock,
   prefillFromParams,
+  provisionWorkspace,
   resolveText,
   syncCodeForm,
   validateField,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usefillo/core",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Form schema, validation, logic engine and JS client for Fillo. Framework-agnostic.",
   "license": "MIT",
   "keywords": [