@pikku/addon-ollama 0.1.5 → 0.1.7

package/dist/.pikku/addon/secrets/pikku-secret-types.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 export { defineSecret } from '@pikku/core/secret';
 //# sourceMappingURL=pikku-secret-types.gen.js.map

package/dist/.pikku/addon/secrets/pikku-secret-types.gen.ts

@@ -1,4 +1,4 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 export { defineSecret } from '@pikku/core/secret'

package/dist/.pikku/addon/secrets/pikku-secrets.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 import { TypedSecretService as CoreTypedSecretService } from '@pikku/core/services';
 import type { SecretService } from '@pikku/core/services';
@@ -11,7 +11,15 @@ import type { SecretService } from '@pikku/core/services';
  * sidecar is not part of `#pikku/secrets`.
  */
 import './pikku-secrets-meta.gen.json';
+/**
+ * Every secret this project declares with `defineSecret`, keyed by name. It is
+ * what gives `secrets.getSecret('NAME')` a real type.
+ */
 export type CredentialsMap = {};
+/**
+ * The `secrets` service as this project sees it: `getSecret('NAME')` resolves
+ * the value's type from `CredentialsMap` instead of returning `unknown`.
+ */
 export declare class TypedSecretService extends CoreTypedSecretService<CredentialsMap> {
     constructor(secrets: SecretService);
 }

package/dist/.pikku/addon/secrets/pikku-secrets.gen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pikku-secrets.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/secrets/pikku-secrets.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,kBAAkB,IAAI,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAEnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD;;;;;;GAMG;AACH,OAAO,+BAA+B,CAAsB;AAE5D,MAAM,MAAM,cAAc,GAAG,EAE5B,CAAA;AAMD,qBAAa,kBAAmB,SAAQ,sBAAsB,CAAC,cAAc,CAAC;gBAChE,OAAO,EAAE,aAAa;CAGnC"}
+{"version":3,"file":"pikku-secrets.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/secrets/pikku-secrets.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,kBAAkB,IAAI,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAEnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD;;;;;;GAMG;AACH,OAAO,+BAA+B,CAAsB;AAE5D;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,EAE5B,CAAA;AAMD;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,sBAAsB,CAAC,cAAc,CAAC;IAC5E,YAAY,OAAO,EAAE,aAAa,EAEjC;CACF"}

package/dist/.pikku/addon/secrets/pikku-secrets.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 import { TypedSecretService as CoreTypedSecretService } from '@pikku/core/services';
 /**
@@ -11,6 +11,10 @@ import { TypedSecretService as CoreTypedSecretService } from '@pikku/core/servic
  */
 import './pikku-secrets-meta.gen.json' with { type: 'json' };
 const CREDENTIALS_META = {};
+/**
+ * The `secrets` service as this project sees it: `getSecret('NAME')` resolves
+ * the value's type from `CredentialsMap` instead of returning `unknown`.
+ */
 export class TypedSecretService extends CoreTypedSecretService {
     constructor(secrets) {
         super(secrets, CREDENTIALS_META);

package/dist/.pikku/addon/secrets/pikku-secrets.gen.js.map

@@ -1 +1 @@
-{"version":3,"file":"pikku-secrets.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/secrets/pikku-secrets.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,kBAAkB,IAAI,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAGnF;;;;;;GAMG;AACH,OAAO,+BAA+B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAM5D,MAAM,gBAAgB,GAAmC,EAExD,CAAA;AAED,MAAM,OAAO,kBAAmB,SAAQ,sBAAsC;IAC5E,YAAY,OAAsB;QAChC,KAAK,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAA;IAClC,CAAC;CACF"}
+{"version":3,"file":"pikku-secrets.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/secrets/pikku-secrets.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,kBAAkB,IAAI,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAGnF;;;;;;GAMG;AACH,OAAO,+BAA+B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAU5D,MAAM,gBAAgB,GAAmC,EAExD,CAAA;AAED;;;GAGG;AACH,MAAM,OAAO,kBAAmB,SAAQ,sBAAsC;IAC5E,YAAY,OAAsB;QAChC,KAAK,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAA;IAClC,CAAC;CACF"}

package/dist/.pikku/addon/secrets/pikku-secrets.gen.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 import { TypedSecretService as CoreTypedSecretService } from '@pikku/core/services'
 import type { CredentialMeta } from '@pikku/core/services'
@@ -13,6 +13,10 @@ import type { SecretService } from '@pikku/core/services'
  */
 import './pikku-secrets-meta.gen.json' with { type: 'json' }
 
+/**
+ * Every secret this project declares with `defineSecret`, keyed by name. It is
+ * what gives `secrets.getSecret('NAME')` a real type.
+ */
 export type CredentialsMap = {
 
 }
@@ -21,6 +25,10 @@ const CREDENTIALS_META: Record<string, CredentialMeta> = {
 
 }
 
+/**
+ * The `secrets` service as this project sees it: `getSecret('NAME')` resolves
+ * the value's type from `CredentialsMap` instead of returning `unknown`.
+ */
 export class TypedSecretService extends CoreTypedSecretService<CredentialsMap> {
   constructor(secrets: SecretService) {
     super(secrets, CREDENTIALS_META)

package/dist/.pikku/addon/services/pikku-meta-service.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 import { LocalMetaService } from '@pikku/core/services/local-meta';
 export declare class PikkuMetaService extends LocalMetaService {

package/dist/.pikku/addon/services/pikku-meta-service.gen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pikku-meta-service.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/services/pikku-meta-service.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAElE,qBAAa,gBAAiB,SAAQ,gBAAgB;;CAIrD"}
+{"version":3,"file":"pikku-meta-service.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/services/pikku-meta-service.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAElE,qBAAa,gBAAiB,SAAQ,gBAAgB;IACpD,cAEC;CACF"}

package/dist/.pikku/addon/services/pikku-meta-service.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 import { LocalMetaService } from '@pikku/core/services/local-meta';
 export class PikkuMetaService extends LocalMetaService {

package/dist/.pikku/addon/services/pikku-meta-service.gen.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 import { LocalMetaService } from '@pikku/core/services/local-meta'
 

package/dist/.pikku/addon/setup/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Subpath entry — `#pikku/setup` resolves here.

package/dist/.pikku/addon/setup/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Subpath entry — `#pikku/setup` resolves here.

package/dist/.pikku/addon/setup/index.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Subpath entry — `#pikku/setup` resolves here.

package/dist/.pikku/addon/setup/pikku-addon-setup-types.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Addon package types for pikkuAddonConfig and pikkuAddonServices
@@ -25,7 +25,7 @@ export type AddonBaseServices = {
  * Unlike pikkuConfig, this receives AddonBaseServices (logger, variables, secrets)
  * from the parent application, so addon packages can read variables/secrets during config creation.
  */
-export declare const pikkuAddonConfig: <ExistingServices extends Omit<Partial<SingletonServices>, "variables" | "secrets"> & AddonBaseServices>(func: (services: ExistingServices) => Promise<Config>) => CreateConfig<Config>;
+export declare const pikkuAddonConfig: <ExistingServices extends Omit<Partial<SingletonServices>, 'variables' | 'secrets'> & AddonBaseServices>(func: (services: ExistingServices) => Promise<Config>) => CreateConfig<Config>;
 /**
  * Creates a Pikku singleton services factory for addon packages.
  * Unlike pikkuServices, this expects the parent application to provide
@@ -46,7 +46,7 @@ export declare const pikkuAddonConfig: <ExistingServices extends Omit<Partial<Si
  * })
  * ```
  */
-export declare const pikkuAddonServices: <T extends Record<string, any>, ExistingServices extends Omit<Partial<SingletonServices>, "variables" | "secrets"> & AddonBaseServices>(func: (config: Config, services: ExistingServices) => Promise<T>) => (config: Config, existingServices?: Partial<SingletonServices>) => Promise<RequiredSingletonServices>;
+export declare const pikkuAddonServices: <T extends Record<string, any>, ExistingServices extends Omit<Partial<SingletonServices>, 'variables' | 'secrets'> & AddonBaseServices>(func: (config: Config, services: ExistingServices) => Promise<T>) => (config: Config, existingServices?: Partial<SingletonServices>) => Promise<RequiredSingletonServices>;
 /**
  * Creates a Pikku wire services factory for addon packages.
  * Wire services are created per-request and have access to the HTTP request context.
@@ -62,5 +62,5 @@ export declare const pikkuAddonServices: <T extends Record<string, any>, Existin
  * })
  * ```
  */
-export declare const pikkuAddonWireServices: <ExistingServices extends Omit<Partial<SingletonServices>, "variables" | "secrets"> & AddonBaseServices>(func: (services: ExistingServices, wire: PikkuWire) => Promise<Record<string, any>>) => any;
+export declare const pikkuAddonWireServices: <ExistingServices extends Omit<Partial<SingletonServices>, 'variables' | 'secrets'> & AddonBaseServices>(func: (services: ExistingServices, wire: PikkuWire) => Promise<Record<string, any>>) => any;
 //# sourceMappingURL=pikku-addon-setup-types.gen.d.ts.map

package/dist/.pikku/addon/setup/pikku-addon-setup-types.gen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pikku-addon-setup-types.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/setup/pikku-addon-setup-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAA;AAC9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uCAAuC,CAAA;AACnE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAA;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAA;AAM3E;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAA;IACnC,SAAS,EAAE,qBAAqB,CAAA;IAChC,OAAO,EAAE,kBAAkB,CAAA;CAC5B,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,gBAAgB,SAAS,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,GAAG,iBAAiB,EACrI,MAAM,CAAC,QAAQ,EAAE,gBAAgB,KAAK,OAAO,CAAC,MAAM,CAAC,KACpD,YAAY,CAAC,MAAM,CAKrB,CAAA;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,kBAAkB,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,gBAAgB,SAAS,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,GAAG,iBAAiB,EACtK,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,KAAK,OAAO,CAAC,CAAC,CAAC,MAElD,QAAQ,MAAM,EAAE,mBAAmB,OAAO,CAAC,iBAAiB,CAAC,KAAG,OAAO,CAAC,yBAAyB,CAchH,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,sBAAsB,GAAI,gBAAgB,SAAS,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,GAAG,iBAAiB,EAC3I,MAAM,CAAC,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,KAM7E,GACP,CAAA"}
+{"version":3,"file":"pikku-addon-setup-types.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/setup/pikku-addon-setup-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAA;AAC9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uCAAuC,CAAA;AACnE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAA;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAA;AAM3E;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAA;IACnC,SAAS,EAAE,qBAAqB,CAAA;IAChC,OAAO,EAAE,kBAAkB,CAAA;CAC5B,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,gBAAgB,SAAS,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,GAAG,iBAAiB,QAC/H,CAAC,QAAQ,EAAE,gBAAgB,KAAK,OAAO,CAAC,MAAM,CAAC,KACpD,YAAY,CAAC,MAAM,CAKrB,CAAA;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,kBAAkB,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,gBAAgB,SAAS,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,GAAG,iBAAiB,QAChK,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,KAAK,OAAO,CAAC,CAAC,CAAC,cAE1C,MAAM,qBAAqB,OAAO,CAAC,iBAAiB,CAAC,KAAG,OAAO,CAAC,yBAAyB,CAchH,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,sBAAsB,GAAI,gBAAgB,SAAS,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,GAAG,iBAAiB,QACrI,CAAC,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,KAM7E,GACP,CAAA"}

package/dist/.pikku/addon/setup/pikku-addon-setup-types.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Addon package types for pikkuAddonConfig and pikkuAddonServices

package/dist/.pikku/addon/setup/pikku-addon-setup-types.gen.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Addon package types for pikkuAddonConfig and pikkuAddonServices

package/dist/.pikku/addon/setup/pikku-setup-types.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Config and service factory definitions, declared once per application
@@ -8,6 +8,10 @@ import { CreateWireServices } from '@pikku/core/types';
 import type { SingletonServices } from '../function/pikku-function-types.gen.js';
 import type { Config } from '../../../types/application-types.d.js';
 import type { RequiredSingletonServices, RequiredWireServices } from '../pikku-services.gen.js';
+/**
+ * This project's own config — whatever `createConfig` returns. Every singleton
+ * service is built from it.
+ */
 export type { Config };
 /**
  * Creates a Pikku config factory.
@@ -16,15 +20,7 @@ export type { Config };
  * @param func - Config factory function that returns your application's config
  * @returns The config factory function
  *
- * @example
- * ```typescript
- * export const createConfig = pikkuConfig(async () => {
- *   return {
- *     apiUrl: process.env.API_URL || 'http://localhost:3000',
- *     dbUrl: process.env.DATABASE_URL
- *   }
- * })
- * ```
+ * @example snippet: pikkuConfig
  */
 export declare const pikkuConfig: (func: (variables?: any, ...args: any[]) => Promise<Config>) => (variables?: any, ...args: any[]) => Promise<Config>;
 /**
@@ -45,7 +41,7 @@ export declare const pikkuConfig: (func: (variables?: any, ...args: any[]) => Pr
  * })
  * ```
  */
-export declare const pikkuServices: (func: (config: Config, existingServices: Partial<SingletonServices>) => Promise<Partial<Omit<RequiredSingletonServices, "auth">>>) => (config: Config, existingServices?: Partial<SingletonServices>) => Promise<RequiredSingletonServices>;
+export declare const pikkuServices: (func: (config: Config, existingServices: Partial<SingletonServices>) => Promise<Partial<Omit<RequiredSingletonServices, 'auth'>>>) => (config: Config, existingServices?: Partial<SingletonServices>) => Promise<RequiredSingletonServices>;
 /**
  * Creates a Pikku wire services factory.
  * Use this to define services that are created per-request/session.
@@ -53,15 +49,7 @@ export declare const pikkuServices: (func: (config: Config, existingServices: Pa
  * @param func - Wire services factory function
  * @returns The wire services factory function
  *
- * @example
- * ```typescript
- * export const createWireServices = pikkuWireServices(async (services, wire) => {
- *   const session = await wire.session?.get()
- *   return {
- *     userCache: new UserCache(session?.userId)
- *   }
- * })
- * ```
+ * @example snippet: shopWireServices
  */
 export declare const pikkuWireServices: (func: (services: SingletonServices, wire: any) => Promise<RequiredWireServices>) => CreateWireServices;
 //# sourceMappingURL=pikku-setup-types.gen.d.ts.map

package/dist/.pikku/addon/setup/pikku-setup-types.gen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pikku-setup-types.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/setup/pikku-setup-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAA;AAChF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uCAAuC,CAAA;AACnE,OAAO,KAAK,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAC/F,YAAY,EAAE,MAAM,EAAE,CAAA;AAEtB;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,kBAAvC,GAAG,WAAW,GAAG,EAAE,KAAK,OAAO,CAAC,MAAM,CAClD,CAAA;AAET;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,aAAa,GACxB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,CAAC,iBAAiB,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC,CAAC,MAEnH,QAAQ,MAAM,EAAE,mBAAkB,OAAO,CAAC,iBAAiB,CAAM,uCAoBhF,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,CACJ,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,GAAG,KACN,OAAO,CAAC,oBAAoB,CAAC,KACjC,kBAIF,CAAA"}
+{"version":3,"file":"pikku-setup-types.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/setup/pikku-setup-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAA;AAChF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uCAAuC,CAAA;AACnE,OAAO,KAAK,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAC/F;;;GAGG;AACH,YAAY,EAAE,MAAM,EAAE,CAAA;AAEtB;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,SAChB,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,kBAAvC,GAAG,WAAW,GAAG,EAAE,KAAK,OAAO,CAAC,MAAM,CAClD,CAAA;AAET;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,aAAa,SAClB,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,CAAC,iBAAiB,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC,CAAC,cAE3G,MAAM,qBAAoB,OAAO,CAAC,iBAAiB,CAAC,uCAgC3E,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,SACtB,CACJ,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,GAAG,KACN,OAAO,CAAC,oBAAoB,CAAC,KACjC,kBAIF,CAAA"}

package/dist/.pikku/addon/setup/pikku-setup-types.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Config and service factory definitions, declared once per application
@@ -12,15 +12,7 @@ import { pikkuState as __pikkuState } from '@pikku/core/state';
  * @param func - Config factory function that returns your application's config
  * @returns The config factory function
  *
- * @example
- * ```typescript
- * export const createConfig = pikkuConfig(async () => {
- *   return {
- *     apiUrl: process.env.API_URL || 'http://localhost:3000',
- *     dbUrl: process.env.DATABASE_URL
- *   }
- * })
- * ```
+ * @example snippet: pikkuConfig
  */
 export const pikkuConfig = (func) => func;
 /**
@@ -45,6 +37,14 @@ export const pikkuServices = (func) => {
     return async (config, existingServices = {}) => {
         const createdServices = await func(config, existingServices);
         const services = { ...existingServices, ...createdServices };
+        const allowedToShadow = new Set([]);
+        const shadowed = Object.keys(createdServices).filter((name) => !allowedToShadow.has(name) &&
+            existingServices[name] !== undefined &&
+            existingServices[name] !== createdServices[name]);
+        if (shadowed.length > 0) {
+            ;
+            services.logger?.warn?.(`createSingletonServices returned its own ${shadowed.join(', ')}, discarding what the host passed in. A host only passes a service it has already configured — a \`secrets\` holding this deployment's values, a \`kysely\` bound to its database — so the replacement starts empty and fails later somewhere unrelated. Write \`existingServices.<name> ?? new Own...\` to take the host's when there is one and still work standalone, or list the name under \`allowShadowedServices\` in pikku.config.json if replacing it is deliberate.`);
+        }
         const authFactory = __pikkuState(null, 'package', 'authFactory');
         if (authFactory) {
             let authInstance;
@@ -70,15 +70,7 @@ export const pikkuServices = (func) => {
  * @param func - Wire services factory function
  * @returns The wire services factory function
  *
- * @example
- * ```typescript
- * export const createWireServices = pikkuWireServices(async (services, wire) => {
- *   const session = await wire.session?.get()
- *   return {
- *     userCache: new UserCache(session?.userId)
- *   }
- * })
- * ```
+ * @example snippet: shopWireServices
  */
 export const pikkuWireServices = (func) => {
     const factories = __pikkuState(null, 'package', 'factories');

package/dist/.pikku/addon/setup/pikku-setup-types.gen.js.map

@@ -1 +1 @@
-{"version":3,"file":"pikku-setup-types.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/setup/pikku-setup-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AAEH,OAAO,EAAE,UAAU,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAO9D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,IAA0D,EAC1D,EAAE,CAAC,IAAI,CAAA;AAET;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,IAAiI,EACjI,EAAE;IACF,OAAO,KAAK,EAAE,MAAc,EAAE,mBAA+C,EAAE,EAAE,EAAE;QACjF,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;QAC5D,MAAM,QAAQ,GAAG,EAAE,GAAG,gBAAgB,EAAE,GAAG,eAAe,EAAE,CAAA;QAC5D,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,aAAa,CAAC,CAAA;QAChE,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,YAA0C,CAC7C;YAAC,QAAgB,CAAC,IAAI,GAAG,GAAG,EAAE;gBAC7B,YAAY,KAAK,OAAO,CAAC,OAAO,EAAE;qBAC/B,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,QAAe,CAAC,CAAC;qBACxC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;oBACf,YAAY,GAAG,SAAS,CAAA;oBACxB,MAAM,KAAK,CAAA;gBACb,CAAC,CAAC,CAAA;gBACJ,OAAO,YAAY,CAAA;YACrB,CAAC,CAAA;QACH,CAAC;QACD,MAAM,QAAQ,GAAG,QAAqC,CAAA;QACtD,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,mBAAmB,EAAE,QAAe,CAAC,CAAA;QACnE,OAAO,QAAQ,CAAA;IACjB,CAAC,CAAA;AACH,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,IAGkC,EACd,EAAE;IACtB,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,CAAA;IAC5D,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE,GAAG,SAAS,EAAE,kBAAkB,EAAE,IAAW,EAAE,CAAC,CAAA;IAC7F,OAAO,IAAqC,CAAA;AAC9C,CAAC,CAAA"}
+{"version":3,"file":"pikku-setup-types.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/setup/pikku-setup-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AAEH,OAAO,EAAE,UAAU,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAW9D;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,IAA0D,EAC1D,EAAE,CAAC,IAAI,CAAA;AAET;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,IAAiI,EACjI,EAAE;IACF,OAAO,KAAK,EAAE,MAAc,EAAE,gBAAgB,GAA+B,EAAE,EAAE,EAAE;QACjF,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;QAC5D,MAAM,QAAQ,GAAG,EAAE,GAAG,gBAAgB,EAAE,GAAG,eAAe,EAAE,CAAA;QAC5D,MAAM,eAAe,GAAG,IAAI,GAAG,CAAS,EAAE,CAAC,CAAA;QAC3C,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,MAAM,CAClD,CAAC,IAAI,EAAE,EAAE,CACP,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC;YACzB,gBAAwB,CAAC,IAAI,CAAC,KAAK,SAAS;YAC5C,gBAAwB,CAAC,IAAI,CAAC,KAAM,eAAuB,CAAC,IAAI,CAAC,CACrE,CAAA;QACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,CAAC;YAAC,QAAgB,CAAC,MAAM,EAAE,IAAI,EAAE,CAC/B,4CAA4C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,+cAA+c,CAC/gB,CAAA;QACH,CAAC;QACD,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,aAAa,CAAC,CAAA;QAChE,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,YAA0C,CAC7C;YAAC,QAAgB,CAAC,IAAI,GAAG,GAAG,EAAE;gBAC7B,YAAY,KAAK,OAAO,CAAC,OAAO,EAAE;qBAC/B,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,QAAe,CAAC,CAAC;qBACxC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;oBACf,YAAY,GAAG,SAAS,CAAA;oBACxB,MAAM,KAAK,CAAA;gBACb,CAAC,CAAC,CAAA;gBACJ,OAAO,YAAY,CAAA;YACrB,CAAC,CAAA;QACH,CAAC;QACD,MAAM,QAAQ,GAAG,QAAqC,CAAA;QACtD,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,mBAAmB,EAAE,QAAe,CAAC,CAAA;QACnE,OAAO,QAAQ,CAAA;IACjB,CAAC,CAAA;AACH,CAAC,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,IAGkC,EACd,EAAE;IACtB,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,CAAA;IAC5D,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE,GAAG,SAAS,EAAE,kBAAkB,EAAE,IAAW,EAAE,CAAC,CAAA;IAC7F,OAAO,IAAqC,CAAA;AAC9C,CAAC,CAAA"}

package/dist/.pikku/addon/setup/pikku-setup-types.gen.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.107
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Config and service factory definitions, declared once per application
@@ -10,6 +10,10 @@ import { CreateWireServices } from '@pikku/core/types'
 import type { SingletonServices } from '../function/pikku-function-types.gen.js'
 import type { Config } from '../../../types/application-types.d.js'
 import type { RequiredSingletonServices, RequiredWireServices } from '../pikku-services.gen.js'
+/**
+ * This project's own config — whatever `createConfig` returns. Every singleton
+ * service is built from it.
+ */
 export type { Config }
 
 /**
@@ -19,15 +23,7 @@ export type { Config }
  * @param func - Config factory function that returns your application's config
  * @returns The config factory function
  *
- * @example
- * ```typescript
- * export const createConfig = pikkuConfig(async () => {
- *   return {
- *     apiUrl: process.env.API_URL || 'http://localhost:3000',
- *     dbUrl: process.env.DATABASE_URL
- *   }
- * })
- * ```
+ * @example snippet: pikkuConfig
  */
 export const pikkuConfig = (
   func: (variables?: any, ...args: any[]) => Promise<Config>
@@ -57,6 +53,18 @@ export const pikkuServices = (
   return async (config: Config, existingServices: Partial<SingletonServices> = {}) => {
     const createdServices = await func(config, existingServices)
     const services = { ...existingServices, ...createdServices }
+    const allowedToShadow = new Set<string>([])
+    const shadowed = Object.keys(createdServices).filter(
+      (name) =>
+        !allowedToShadow.has(name) &&
+        (existingServices as any)[name] !== undefined &&
+        (existingServices as any)[name] !== (createdServices as any)[name]
+    )
+    if (shadowed.length > 0) {
+      ;(services as any).logger?.warn?.(
+        `createSingletonServices returned its own ${shadowed.join(', ')}, discarding what the host passed in. A host only passes a service it has already configured — a \`secrets\` holding this deployment's values, a \`kysely\` bound to its database — so the replacement starts empty and fails later somewhere unrelated. Write \`existingServices.<name> ?? new Own...\` to take the host's when there is one and still work standalone, or list the name under \`allowShadowedServices\` in pikku.config.json if replacing it is deliberate.`
+      )
+    }
     const authFactory = __pikkuState(null, 'package', 'authFactory')
     if (authFactory) {
       let authInstance: Promise<unknown> | undefined
@@ -83,15 +91,7 @@ export const pikkuServices = (
  * @param func - Wire services factory function
  * @returns The wire services factory function
  *
- * @example
- * ```typescript
- * export const createWireServices = pikkuWireServices(async (services, wire) => {
- *   const session = await wire.session?.get()
- *   return {
- *     userCache: new UserCache(session?.userId)
- *   }
- * })
- * ```
+ * @example snippet: shopWireServices
  */
 export const pikkuWireServices = (
   func: (