kizlo 0.22.1 → 0.23.0

package/dist/cli/daemon/generate.js

@@ -17,12 +17,23 @@ import fs from "node:fs";
 * The generated barrel is also written as a stub by `kizlo init`. It re-exports `introspection`
 * rather than pre-wrapping it: a server entry passes `createKizlo({ introspection })` itself, so the
 * rest of the options stay visible at the call site instead of hiding inside a generated object.
+*
+* `contract` is left with the JSON's own type and the project's `procedures` are registered instead.
+* The old `as unknown as typeof procedures` asserted that the committed JSON and the exported tree
+* agreed rather than establishing it, and left the client type reachable only by holding the value.
 */
 const CONTRACT_BARREL = [
 	`import type { procedures } from ".."`,
 	`import contractJson from "./contract.json"`,
 	``,
-	`export const contract = contractJson as unknown as typeof procedures`,
+	`export const contract = contractJson`,
+	``,
+	`declare module "kizlo" {`,
+	`\tinterface KizloProcedureRegistry {`,
+	`\t\tprocedures: typeof procedures`,
+	`\t}`,
+	`}`,
+	``,
 	`export { introspection, type WordPressClient } from "./introspection"`,
 	``
 ].join("\n");

package/dist/client.d.ts

@@ -2,23 +2,46 @@ import { AnyProcedureTree, ExtractProcedureByScope } from "./shared/procedure.js
 import { ResultClient } from "./shared/result.js";
 
 //#region src/client.d.ts
+
+/**
+ * Generated code augments this in the project that owns the contract: `kizlo generate` writes a
+ * barrel that registers its `procedures` here, which is what gives {@link ActiveKizloClient} that
+ * project's own types without a cast.
+ */
+interface KizloProcedureRegistry {}
+/**
+ * The browser client this project compiles against. The `any` short-circuit is on the whole client
+ * rather than on the procedure tree: passing `any` through `ResultClient` distributes to a union
+ * whose second property access fails, so an unregistered project would stop compiling instead of
+ * staying loose.
+ */
+type ActiveKizloClient = KizloProcedureRegistry extends {
+  procedures: infer TProcedures extends AnyProcedureTree;
+} ? ResultClient<ExtractProcedureByScope<TProcedures, "remote" | "api">> : any;
+/** What {@link createKizloClient} returns: a {@link KizloClient} typed from the registry instead of its argument. */
+interface KizloBrowserClient {
+  readonly client: ActiveKizloClient;
+}
 interface KizloClientConfig<T extends AnyProcedureTree> {
   url?: string;
   contract: T;
   fetch?: (request: Request) => Promise<Response>;
 }
-declare class KizloClient<TProcedures extends AnyProcedureTree> {
-  readonly client: ResultClient<ExtractProcedureByScope<TProcedures, "remote" | "api">>;
-  protected readonly config: KizloClientConfig<TProcedures>;
-  constructor(config: KizloClientConfig<TProcedures>);
+declare class KizloClient<TProcedures$1 extends AnyProcedureTree> {
+  readonly client: ResultClient<ExtractProcedureByScope<TProcedures$1, "remote" | "api">>;
+  protected readonly config: KizloClientConfig<TProcedures$1>;
+  constructor(config: KizloClientConfig<TProcedures$1>);
   private getUrl;
 }
 /**
  * Creates a browser client for a generated contract. Defaults the URL to the
  * current origin (`window.location.origin`); framework packages wrap this to resolve it from their env.
+ *
+ * `contract` is the runtime routing table only. The type comes from {@link KizloProcedureRegistry},
+ * which the generated barrel augments, so the client is typed even where the value is not in hand.
  */
-declare function createKizloClient<T extends AnyProcedureTree>(contract: T, options?: {
+declare function createKizloClient(contract: unknown, options?: {
   url?: string;
-}): KizloClient<T>;
+}): KizloBrowserClient;
 //#endregion
-export { KizloClient, KizloClientConfig, createKizloClient };
+export { ActiveKizloClient, KizloBrowserClient, KizloClient, KizloClientConfig, KizloProcedureRegistry, createKizloClient };

package/dist/client.js

@@ -43,6 +43,9 @@ var KizloClient = class {
 /**
 * Creates a browser client for a generated contract. Defaults the URL to the
 * current origin (`window.location.origin`); framework packages wrap this to resolve it from their env.
+*
+* `contract` is the runtime routing table only. The type comes from {@link KizloProcedureRegistry},
+* which the generated barrel augments, so the client is typed even where the value is not in hand.
 */
 function createKizloClient(contract, options) {
 	return new KizloClient({

package/dist/index.d.ts

@@ -33,7 +33,7 @@ import { InferProcedureData, InferProcedureError, InferProcedureInput, InferProc
 import { AnyKizloConfig, CreateKizloOptions, Kizlo, KizloConfig, RootProcedures, S2SClient, createKizlo, integrationEnv, resolveKizloConfig, resolveWordPressConnection, wordPressConnectionComplete } from "./kizlo.js";
 import { WEB_MANIFEST_ROUTE, WebManifest, buildWebManifest, createManifestRoute } from "./brand/manifest.js";
 import "./brand/index.js";
-import { KizloClient, KizloClientConfig, createKizloClient } from "./client.js";
+import { ActiveKizloClient, KizloBrowserClient, KizloClient, KizloClientConfig, KizloProcedureRegistry, createKizloClient } from "./client.js";
 import { CONTENT_TYPES, ContentType, ListSitemapUrlInput, ListSitemapUrlInputBase, Robots, RobotsRule, Seo, SeoHead, SeoSchema, Sitemap, SitemapIndex, SitemapList, SitemapUrl, SitemapUrlImage, SitemapUrlList } from "./seo/schema.js";
 import { WPK_RobotRule, WPK_Robots, WPK_Seo, WPK_Sitemap, WPK_SitemapUrl, WPK_SitemapUrlImage } from "./seo/types.js";
 import { SitemapIndexEntry, deserializeSeo, parseSitemapSlug, renderJsonLd, renderSitemapIndex, renderUrlSet, sitemapEntryPath, xmlResponse } from "./seo/utils.js";
@@ -43,4 +43,4 @@ import { ShaAlgorithm, compare, hash, hmac } from "./shared/crypto.js";
 import { Identifier, parseIdentifier } from "./shared/identifier.js";
 import { createOrpcRouter } from "./shared/router.js";
 import { deserializeCurrencyFormat, deserializeListMetadata, emptyList, serializeCurrencyFormat } from "./shared/serialize.js";
-export { ActiveWordPressClient, AnyContext, AnyEventSchema, AnyEvents, AnyIntegration, AnyKizloConfig, AnyMiddleware, AnyNestedClient, AnyProcedure, AnyProcedureTree, AuthAdapter, AuthGetSession, AuthUser, AuthorsSettings, AuthorsSettingsInput, BaseHandlerOptions, BrandSettings, BrandSettingsInput, COMMON_ERRORS, CONTENT_TYPES, CORE_PROCEDURES, CaptchaAdapter, type Category, type CategoryCustomFields, CategoryCustomFieldsSchema, CommonErrorCode, CommonErrorLiteral, CommonErrorMap, ConnInfo, ConnInfoFn, ConsoleLogAdapterOptions, ContentType, Context, ContextConfig, Contract, ContractProcedure, CookiesAdapter, CookiesDeleteAll, CookiesGetAll, CookiesSetAll, CookiesStorage, CoreProcedures, CrawlingSettings, CrawlingSettingsInput, CreateKizloOptions, CreateSitemapRouteOptions, CurrencyFormat, DefinedErrorMapLike, DevPluginSource, EnvReader, EnvRecord, EnvSource, ErrorDefinition, EventHandler, EventHandlerFn, ExtractIntegrationProcedures, ExtractMiddlewareContextOutput, ExtractParams, ExtractProcedureByScope, Fixture, FixtureCleanupFn, FixtureSeedFn, FixtureSettleFn, GeoAdapter, GeoGetConnInfo, HTTPMethod, HeadlessSettings, HeadlessSettingsInput, IconDescriptor, Identifier, IdentifierInput, IdentitySettings, IdentitySettingsInput, InferEventUnion, InferIntegrationProcedures, InferMiddlewares, InferProcedureData, InferProcedureError, InferProcedureInput, InferProcedureResult, Integration, IntegrationRequirements, InvocationScope, JsonValue, Kizlo, KizloClient, KizloClientConfig, KizloConfig, KizloEnv, KizloError, KizloErrorOptions, KizloErrorUnion, KizloResult, LIST_ORDER, List, ListMetadata, ListOrder, ListSitemapUrlInput, ListSitemapUrlInputBase, LocalPlugin, LogLevel, LogPayload, Logger, LoggerAdapter, ManifestIcon, MaybeCallerOptions, MaybeOptionalOptions, Middleware, MiddlewareHandler, MiddlewareNextFn, MiddlewareOptions, MiddlewareResult, OpenapiPart, OrganizationFounder, OrganizationSettings, OrganizationSettingsInput, type Page, type PageCustomFields, PageCustomFieldsSchema, PersonSettings, PersonSettingsInput, PluginSource, type Post, type PostCustomFields, PostCustomFieldsSchema, PostStatusDefinition, PostTypeSettings, PostTypeSettingsInput, PreviewTokenData, PreviewTokenPayload, Procedure, ProcedureContext, ProcedureErrors, ProcedureHandler, ProcedureMethod, ProcedureOptions, ProcedureTreeDepthTuple, RedirectInput, RedirectStatus, ResolveParamsPart, ResolvedIcons, ResolvedSchemaInput, ResolvedSchemaOutput, ResultClient, Robots, RobotsRule, RootProcedures, S2SClient, SITEMAP_BASE, SITEMAP_INDEX_SLUG, SchemaIO, SeedContext, Seo, SeoHead, SeoSchema, ServiceAdapters, SessionFn, Settings, SettingsService, SettleContext, ShaAlgorithm, SiteSettings, SiteSettingsInput, Sitemap, SitemapIndex, SitemapIndexEntry, SitemapList, SitemapRouteExtra, SitemapUrl, SitemapUrlImage, SitemapUrlList, SocialProfile, type Tag, type TagCustomFields, TagCustomFieldsSchema, TaxonomySettings, TaxonomySettingsInput, TestAdminUser, TestCredentials, TestUser, ThrowableErrorFn, ThrowableErrorMap, UploadsSettings, UploadsSettingsInput, VerifyCaptchaFn, VerifyPreviewTokenFn, WEB_MANIFEST_ROUTE, WPK_RobotRule, WPK_Robots, WPK_Seo, WPK_Sitemap, WPK_SitemapUrl, WPK_SitemapUrlImage, WP_CallOptions, WP_Client, WP_CommonErrorCode, WP_CurrencyFormat, WP_CustomFields, WP_CustomFieldsPath, WP_Endpoint, WP_EndpointData, WP_EndpointDefinition, WP_EndpointError, WP_EndpointInput, WP_EndpointPath, WP_EndpointResult, WP_Error, WP_ErrorData, WP_Failure, WP_List, WP_ListMetadata, WP_RequestBuild, WP_RequestContentType, WP_RequestInput, WP_RequestMethod, WP_RequestParts, WP_ResponseContentType, WP_Result, WP_Success, WP_TransportFailure, WP_TypedHeaders, WebManifest, WebhookOptions, WebhookSettings, WebhookSettingsInput, WithCommonErrorMap, WordPressClientRegistry, WordPressCredentials, WordPressCustomFieldsRegistry, WordPressEndpointRegistry, WordPressEnv, WordPressTransport, WordPressTransportOptions, WordPressTransportResult, altcha, arkose, assertIntegrationEndpoints, assertIntegrationEnv, authMock, buildProcedure, buildWebManifest, buildWordPressRequest, combineDetailed, compare, consoleLog, createAuthAdapter, createCaptchaAdapter, createCookiesAdapter, createEventHandler, createGeoAdapter, createIntegration, createKizlo, createKizloClient, createLoggerAdapter, createManifestRoute, createMiddleware, createOrpcRouter, createProcedure, createResultClient, createSitemapRedirectRoute, createSitemapRoute, createThrowableErrorMap, createWebhookRouter, createWordPressClient, customFieldsSchema, defineErrorMap, defineFixture, deserializeCurrencyFormat, deserializeListMetadata, deserializeSeo, emptyList, friendlyCaptcha, generateContract, geoMock, geoVercelNext, handleUnexpectedError, hash, hcaptcha, hmac, integrationEnv, isContractProcedure, isKizloError, isLocalPlugin, isWordPressResourceError, mergeServiceAdapters, missingEndpoints, missingEnv, noopAdapter, parseIdentifier, parseSitemapSlug, readEnv, recaptcha, renderJsonLd, renderSitemapIndex, renderUrlSet, resolveIcons, resolveKizloConfig, resolveWordPressConnection, restoreContract, schemaType, serializeCurrencyFormat, sitemapEntryPath, sortIntegrations, toKizloError, turnstile, wordPressConnectionComplete, wpEndpoint, xmlResponse };
+export { ActiveKizloClient, ActiveWordPressClient, AnyContext, AnyEventSchema, AnyEvents, AnyIntegration, AnyKizloConfig, AnyMiddleware, AnyNestedClient, AnyProcedure, AnyProcedureTree, AuthAdapter, AuthGetSession, AuthUser, AuthorsSettings, AuthorsSettingsInput, BaseHandlerOptions, BrandSettings, BrandSettingsInput, COMMON_ERRORS, CONTENT_TYPES, CORE_PROCEDURES, CaptchaAdapter, type Category, type CategoryCustomFields, CategoryCustomFieldsSchema, CommonErrorCode, CommonErrorLiteral, CommonErrorMap, ConnInfo, ConnInfoFn, ConsoleLogAdapterOptions, ContentType, Context, ContextConfig, Contract, ContractProcedure, CookiesAdapter, CookiesDeleteAll, CookiesGetAll, CookiesSetAll, CookiesStorage, CoreProcedures, CrawlingSettings, CrawlingSettingsInput, CreateKizloOptions, CreateSitemapRouteOptions, CurrencyFormat, DefinedErrorMapLike, DevPluginSource, EnvReader, EnvRecord, EnvSource, ErrorDefinition, EventHandler, EventHandlerFn, ExtractIntegrationProcedures, ExtractMiddlewareContextOutput, ExtractParams, ExtractProcedureByScope, Fixture, FixtureCleanupFn, FixtureSeedFn, FixtureSettleFn, GeoAdapter, GeoGetConnInfo, HTTPMethod, HeadlessSettings, HeadlessSettingsInput, IconDescriptor, Identifier, IdentifierInput, IdentitySettings, IdentitySettingsInput, InferEventUnion, InferIntegrationProcedures, InferMiddlewares, InferProcedureData, InferProcedureError, InferProcedureInput, InferProcedureResult, Integration, IntegrationRequirements, InvocationScope, JsonValue, Kizlo, KizloBrowserClient, KizloClient, KizloClientConfig, KizloConfig, KizloEnv, KizloError, KizloErrorOptions, KizloErrorUnion, KizloProcedureRegistry, KizloResult, LIST_ORDER, List, ListMetadata, ListOrder, ListSitemapUrlInput, ListSitemapUrlInputBase, LocalPlugin, LogLevel, LogPayload, Logger, LoggerAdapter, ManifestIcon, MaybeCallerOptions, MaybeOptionalOptions, Middleware, MiddlewareHandler, MiddlewareNextFn, MiddlewareOptions, MiddlewareResult, OpenapiPart, OrganizationFounder, OrganizationSettings, OrganizationSettingsInput, type Page, type PageCustomFields, PageCustomFieldsSchema, PersonSettings, PersonSettingsInput, PluginSource, type Post, type PostCustomFields, PostCustomFieldsSchema, PostStatusDefinition, PostTypeSettings, PostTypeSettingsInput, PreviewTokenData, PreviewTokenPayload, Procedure, ProcedureContext, ProcedureErrors, ProcedureHandler, ProcedureMethod, ProcedureOptions, ProcedureTreeDepthTuple, RedirectInput, RedirectStatus, ResolveParamsPart, ResolvedIcons, ResolvedSchemaInput, ResolvedSchemaOutput, ResultClient, Robots, RobotsRule, RootProcedures, S2SClient, SITEMAP_BASE, SITEMAP_INDEX_SLUG, SchemaIO, SeedContext, Seo, SeoHead, SeoSchema, ServiceAdapters, SessionFn, Settings, SettingsService, SettleContext, ShaAlgorithm, SiteSettings, SiteSettingsInput, Sitemap, SitemapIndex, SitemapIndexEntry, SitemapList, SitemapRouteExtra, SitemapUrl, SitemapUrlImage, SitemapUrlList, SocialProfile, type Tag, type TagCustomFields, TagCustomFieldsSchema, TaxonomySettings, TaxonomySettingsInput, TestAdminUser, TestCredentials, TestUser, ThrowableErrorFn, ThrowableErrorMap, UploadsSettings, UploadsSettingsInput, VerifyCaptchaFn, VerifyPreviewTokenFn, WEB_MANIFEST_ROUTE, WPK_RobotRule, WPK_Robots, WPK_Seo, WPK_Sitemap, WPK_SitemapUrl, WPK_SitemapUrlImage, WP_CallOptions, WP_Client, WP_CommonErrorCode, WP_CurrencyFormat, WP_CustomFields, WP_CustomFieldsPath, WP_Endpoint, WP_EndpointData, WP_EndpointDefinition, WP_EndpointError, WP_EndpointInput, WP_EndpointPath, WP_EndpointResult, WP_Error, WP_ErrorData, WP_Failure, WP_List, WP_ListMetadata, WP_RequestBuild, WP_RequestContentType, WP_RequestInput, WP_RequestMethod, WP_RequestParts, WP_ResponseContentType, WP_Result, WP_Success, WP_TransportFailure, WP_TypedHeaders, WebManifest, WebhookOptions, WebhookSettings, WebhookSettingsInput, WithCommonErrorMap, WordPressClientRegistry, WordPressCredentials, WordPressCustomFieldsRegistry, WordPressEndpointRegistry, WordPressEnv, WordPressTransport, WordPressTransportOptions, WordPressTransportResult, altcha, arkose, assertIntegrationEndpoints, assertIntegrationEnv, authMock, buildProcedure, buildWebManifest, buildWordPressRequest, combineDetailed, compare, consoleLog, createAuthAdapter, createCaptchaAdapter, createCookiesAdapter, createEventHandler, createGeoAdapter, createIntegration, createKizlo, createKizloClient, createLoggerAdapter, createManifestRoute, createMiddleware, createOrpcRouter, createProcedure, createResultClient, createSitemapRedirectRoute, createSitemapRoute, createThrowableErrorMap, createWebhookRouter, createWordPressClient, customFieldsSchema, defineErrorMap, defineFixture, deserializeCurrencyFormat, deserializeListMetadata, deserializeSeo, emptyList, friendlyCaptcha, generateContract, geoMock, geoVercelNext, handleUnexpectedError, hash, hcaptcha, hmac, integrationEnv, isContractProcedure, isKizloError, isLocalPlugin, isWordPressResourceError, mergeServiceAdapters, missingEndpoints, missingEnv, noopAdapter, parseIdentifier, parseSitemapSlug, readEnv, recaptcha, renderJsonLd, renderSitemapIndex, renderUrlSet, resolveIcons, resolveKizloConfig, resolveWordPressConnection, restoreContract, schemaType, serializeCurrencyFormat, sitemapEntryPath, sortIntegrations, toKizloError, turnstile, wordPressConnectionComplete, wpEndpoint, xmlResponse };

package/dist/integrations/astro/kizlo.client.d.ts

@@ -1,5 +1,4 @@
-import { AnyProcedureTree } from "../../shared/procedure.js";
-import { KizloClient } from "../../client.js";
+import { KizloBrowserClient } from "../../client.js";
 
 //#region src/integrations/astro/kizlo.client.d.ts
 interface KizloClientOptions {
@@ -10,6 +9,6 @@ interface KizloClientOptions {
    */
   url?: string;
 }
-declare function createKizloClient<T extends AnyProcedureTree>(contract: T, options?: KizloClientOptions): KizloClient<T>;
+declare function createKizloClient(contract: unknown, options?: KizloClientOptions): KizloBrowserClient;
 //#endregion
 export { KizloClientOptions, createKizloClient };

package/dist/integrations/astro/kizlo.client.js

@@ -1,13 +1,10 @@
-import { KizloClient } from "../../client.js";
+import { createKizloClient } from "../../client.js";
 import { getServerBaseUrl } from "./utils.js";
 
 //#region src/integrations/astro/kizlo.client.ts
-function createKizloClient(contract, options) {
-	return new KizloClient({
-		url: options?.url ?? getServerBaseUrl(),
-		contract
-	});
+function createKizloClient$1(contract, options) {
+	return createKizloClient(contract, { url: options?.url ?? getServerBaseUrl() });
 }
 
 //#endregion
-export { createKizloClient };
+export { createKizloClient$1 as createKizloClient };

package/dist/integrations/nextjs/kizlo.client.d.ts

@@ -1,10 +1,9 @@
-import { AnyProcedureTree } from "../../shared/procedure.js";
-import { KizloClient } from "../../client.js";
+import { KizloBrowserClient } from "../../client.js";
 
 //#region src/integrations/nextjs/kizlo.client.d.ts
 interface KizloClientOptions {
   url?: string;
 }
-declare function createKizloClient<T extends AnyProcedureTree>(contract: T, options?: KizloClientOptions): KizloClient<T>;
+declare function createKizloClient(contract: unknown, options?: KizloClientOptions): KizloBrowserClient;
 //#endregion
 export { KizloClientOptions, createKizloClient };

package/dist/integrations/nextjs/kizlo.client.js

@@ -1,13 +1,10 @@
-import { KizloClient } from "../../client.js";
+import { createKizloClient } from "../../client.js";
 import { getServerBaseUrl } from "./utils.js";
 
 //#region src/integrations/nextjs/kizlo.client.ts
-function createKizloClient(contract, options) {
-	return new KizloClient({
-		url: options?.url ?? getServerBaseUrl(),
-		contract
-	});
+function createKizloClient$1(contract, options) {
+	return createKizloClient(contract, { url: options?.url ?? getServerBaseUrl() });
 }
 
 //#endregion
-export { createKizloClient };
+export { createKizloClient$1 as createKizloClient };

package/dist/integrations/tanstack-start/kizlo.client.d.ts

@@ -1,5 +1,4 @@
-import { AnyProcedureTree } from "../../shared/procedure.js";
-import { KizloClient } from "../../client.js";
+import { KizloBrowserClient } from "../../client.js";
 
 //#region src/integrations/tanstack-start/kizlo.client.d.ts
 interface KizloClientOptions {
@@ -15,6 +14,6 @@ interface KizloClientOptions {
  * over HTTP, so it runs the same in the browser and during SSR. Server routes and server functions use
  * the server-to-server client from {@link createKizlo} instead.
  */
-declare function createKizloClient<T extends AnyProcedureTree>(contract: T, options?: KizloClientOptions): KizloClient<T>;
+declare function createKizloClient(contract: unknown, options?: KizloClientOptions): KizloBrowserClient;
 //#endregion
 export { KizloClientOptions, createKizloClient };

package/dist/integrations/tanstack-start/kizlo.client.js

@@ -1,4 +1,4 @@
-import { KizloClient } from "../../client.js";
+import { createKizloClient } from "../../client.js";
 import { getServerBaseUrl } from "./utils.js";
 
 //#region src/integrations/tanstack-start/kizlo.client.ts
@@ -7,12 +7,9 @@ import { getServerBaseUrl } from "./utils.js";
 * over HTTP, so it runs the same in the browser and during SSR. Server routes and server functions use
 * the server-to-server client from {@link createKizlo} instead.
 */
-function createKizloClient(contract, options) {
-	return new KizloClient({
-		url: options?.url ?? getServerBaseUrl(),
-		contract
-	});
+function createKizloClient$1(contract, options) {
+	return createKizloClient(contract, { url: options?.url ?? getServerBaseUrl() });
 }
 
 //#endregion
-export { createKizloClient };
+export { createKizloClient$1 as createKizloClient };

package/dist/package.js

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "0.22.1";
+var version = "0.23.0";
 
 //#endregion
 export { version };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kizlo",
-  "version": "0.22.1",
+  "version": "0.23.0",
   "type": "module",
   "description": "A headless WordPress framework for TypeScript.",
   "keywords": [